From 07d786e487318c3b8720c977dfb1de744d4bbd13 Mon Sep 17 00:00:00 2001 From: Nicole Rappe Date: Mon, 26 Jan 2026 19:08:33 -0700 Subject: [PATCH] Update Servers/Documentation/Zensical.md --- Servers/Documentation/Zensical.md | 58 +++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) diff --git a/Servers/Documentation/Zensical.md b/Servers/Documentation/Zensical.md index bfc5a4e..ce63c93 100644 --- a/Servers/Documentation/Zensical.md +++ b/Servers/Documentation/Zensical.md @@ -210,3 +210,61 @@ sudo systemctl daemon-reload sudo systemctl enable --now gitea-runner.service ``` +#### Gitea Runner Repository Workflow +Place the following file into your documentation repository at the given location and this will enable the runner to execute when changes happen to the repository data. + +```yaml title="gitea/workflows/gitops-automatic-deployment.yml" +name: GitOps Automatic Documentation Deployment + +on: + push: + branches: [ main ] + +jobs: + zensical_deploy: + name: Sync Docs to https://kb.bunny-lab.io + runs-on: zensical-host + + steps: + - name: Checkout Repository + uses: actions/checkout@v3 + + - name: Sync repository into /srv/zensical/docs + run: | + rsync -rlD --delete \ + --exclude='.git/' \ + --exclude='.gitea/' \ + --exclude='assets/' \ + --exclude='schema/' \ + --exclude='stylesheets/' \ + --exclude='schema.json' \ + --chmod=D2775,F664 \ + . /srv/zensical/docs/ + + - name: Notify via NTFY + if: always() + run: | + curl -d "https://kb.bunny-lab.io - Zensical job status: ${{ job.status }}" https://ntfy.bunny-lab.io/gitea-runners +``` + +### Traefik Reverse Proxy Configuration +It is assumed that you use a [Traefik](https://kb.bunny-lab.io/Servers/Containerization/Docker/Compose/Traefik/) reverse proxy and are configured to use [dynamic configuration files](https://kb.bunny-lab.io/Servers/Containerization/Docker/Compose/Traefik/#dynamic-configuration-files). Add the file below to expose the Zensical service to the rest of the world. + +```yaml title="kb.bunny-lab.io.yml" +http: + routers: + kb: + entryPoints: + - websecure + tls: + certResolver: letsencrypt + service: kb + rule: Host(`kb.bunny-lab.io`) + + services: + kb: + loadBalancer: + servers: + - url: http://192.168.3.8:80 + passHostHeader: true +``` \ No newline at end of file