npm

wiki/build-pipeline.md

@@ -0,0 +1,31 @@
+# Appmodel Home Lab – Build & Deploy Pipeline
+
+Dit document beschrijft hoe een nieuwe applicatie in het home lab wordt aangemaakt en hoe de build- & deploy-pipeline werkt.
+
+## Overzicht
+
+- **Broncode**: Gitea (`https://git.appmodel.nl`)
+- **Build & runtime**: Docker containers op netwerk `traefik_net`
+- **Routing & TLS**: Traefik (`https://traefik.appmodel.nl`)
+- **Automatische deploy**: Gitea `post-receive` hooks → `app-deploy <app>`
+
+## Pipeline in één diagram
+
+```mermaid
+flowchart LR
+  Dev[💻 Dev machine\nVS Code / Git] -->|git push| Gitea[📚 Gitea\nTour/<app>]
+
+  subgraph Server[🏠 Home lab server\n192.168.1.159]
+    Gitea --> Hook[🔔 post-receive hook\n/app-deploy <app>]
+
+    Hook --> Deploy[⚙️ app-deploy <app>\n/git pull + docker compose up -d --build <app>]
+
+    subgraph Docker[🐳 Docker / traefik_net]
+      AppC[🧱 App container\n<app>.appmodel.nl]
+      Traefik[🚦 Traefik\nReverse Proxy]
+    end
+  end
+
+  Deploy --> AppC
+  Traefik --> AppC
+  Client[🌐 Browser / API client] -->|https://<app>.appmodel.nl| Traefik