bunny-lab/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update Servers/Documentation/Zensical.md
All checks were successful
GitOps Automatic Documentation Deployment / Sync Docs to https://kb.bunny-lab.io (push) Successful in 4s
Details
GitOps Automatic Documentation Deployment / Sync Docs to https://docs.bunny-lab.io (push) Successful in 6s
Details

Browse Source
This commit is contained in:
Nicole Rappe
2026-01-26 19:13:43 -07:00
parent ff9b261349
commit 6300150012
1 changed files with 11 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
Servers/Documentation/Zensical.md
View File

@@ -10,36 +10,18 @@ It is useful to understand the flow of data and how everything inter-connects, s
``` mermaid ``` mermaid
sequenceDiagram sequenceDiagram
autonumber autonumber
actor Author as Docs Author actor Author as Doc Author
participant Gitea as Gitea Repo (git.bunny-lab.io) participant Gitea as Gitea (Repo + Actions)
participant Actions as Gitea Actions Workflow participant Runner as Act Runner
participant Runner as Gitea Act Runner (zensical-docs-runner) participant Zensical as Zensical Server (watch + build)
participant FS as Zensical Host FS (/srv/zensical/docs) participant NGINX as NGINX (serves static site)
participant Watchdog as systemd: zensical-watchdog.service<br/>(zensical serve)
participant Build as Zensical Builder
participant Site as Static Site Dir (/srv/zensical/site)
participant NGINX as NGINX (root=/srv/zensical/site)
participant Traefik as Traefik Reverse Proxy
participant User as Web Client
participant NTFY as NTFY (ntfy.bunny-lab.io)
Author->>Gitea: Push changes to main Author->>Gitea: Push to main
Gitea-->>Actions: Trigger workflow on push (main) Gitea-->>Runner: Trigger workflow job
Actions-->>Runner: Schedule job (runs-on: zensical-host) Runner->>Zensical: rsync docs → /srv/zensical/docs
Zensical-->>Zensical: Watch detects change
Runner->>Gitea: Checkout repository (actions/checkout) Zensical->>Zensical: Rebuild site → /srv/zensical/site
Runner->>FS: rsync repo → /srv/zensical/docs/<br/>--delete, excludes, chmod D2775/F664 NGINX-->>NGINX: Serve files from /srv/zensical/site
Note over FS,Watchdog: zensical serve watches docs directory for changes
Watchdog-->>Build: Detect filesystem changes (watchdog event)
Build->>Site: Rebuild static site output<br/>(write into /srv/zensical/site)
User->>Traefik: HTTPS request kb.bunny-lab.io
Traefik->>NGINX: Proxy to http://192.168.3.8:80
NGINX->>Site: Read built files (index.html, assets)
NGINX-->>User: Serve newly-built content
Runner-->>NTFY: Notify job status (always)<br/>curl -d "…status…" topic=gitea-runners
``` ```
### Setup Python Environment ### Setup Python Environment