From c1317d7292c87a7beb20756ca174d1406b38869c Mon Sep 17 00:00:00 2001 From: Jarkko Toivanen Date: Sat, 25 Jan 2025 03:10:15 +0200 Subject: [PATCH] Update forgejo mkdocs cicd docu --- docs/mkdocs/forgejo-ci.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/docs/mkdocs/forgejo-ci.md b/docs/mkdocs/forgejo-ci.md index 5e7cca6..77c73f8 100644 --- a/docs/mkdocs/forgejo-ci.md +++ b/docs/mkdocs/forgejo-ci.md @@ -3,6 +3,15 @@ !!! TODO This documentation might not be complete + +!!! INFO + There are plenty of things you need + to customize accordingly like hosts and + usernames and preferred directories. + + +## Server side of things + ``` console Install required stuff and things on Debian based system $ sudo apt-get install rsync @@ -30,6 +39,8 @@ give us permission to get connected via ssh (might not be needed) Change it afterwards using `sudo usermod -s /Sbin/HELL verkkojuuri` +## Forgejo side of things + Then you just like build and like rsync the files using a forgejo action runner passing it the relevant secrets. In practise you'll make it execute @@ -39,6 +50,18 @@ $ mkdocs build $ rsync -e "ssh -rclthv --exclude --delete-after .git site/ verkkojuuri@jakest.us:site ``` +Oh you need it more detailed, okay. + +1. Set *secret* `SSH_PRIVATE_KEY` to have non-password-protected ssh private key +(you should have done that in previousu steps). +2. Set following *variables* + - `SSH_USER`: verkkojuuri + - `SSH_HOST`: jakest.us + - `SSH_PATH`: site +3. Setup the action itself (refer to workflow actions in + [my repo](https://git.jakest.us/jt/saitti/) + perhaps) +4. Enjoy And well yeah serve them files with Apache or whatever.