viewer/build-pipeline.md

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

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