view

readme-pipe.md

@@ -0,0 +1,141 @@
+1. Nieuwe app aanmaken
+1.1 Gitea repo
+
+Log in op Gitea: https://git.appmodel.nl
+
+Maak een nieuwe repo aan, bijvoorbeeld:
+
+Owner: Tour
+
+Name: viewer
+
+1.2 Skeleton genereren op de server
+
+Op de server:
+
+apps-create viewer static-fe
+
+
+Dit doet:
+
+/opt/apps/viewer klaarzetten (proberen te clonen uit git@git.appmodel.nl:Tour/viewer.git)
+
+een multi-stage Dockerfile voor een Node-based static frontend aanmaken
+
+~/infra/viewer/docker-compose.yml aanmaken met:
+
+service viewer
+
+koppeling aan traefik_net
+
+Traefik route: https://viewer.appmodel.nl
+
+2. Develop & build
+
+Op je dev machine:
+
+git clone git@git.appmodel.nl:Tour/viewer.git
+cd viewer
+# bouw je app zoals normaal
+npm install
+npm run build   # output in dist/
+git add .
+git commit -m "First version"
+git push
+
+
+De Dockerfile verwacht een dist/ map met static files.
+
+3. Deploy pipeline
+3.1 app-deploy <app>
+
+Op de server verzorgt app-deploy de generieke deploy:
+
+app-deploy viewer
+
+
+Doet:
+
+cd /opt/apps/viewer
+
+git pull --ff-only
+
+cd /home/tour/infra/viewer
+
+docker compose up -d --build viewer
+
+Logs komen in:
+
+/var/log/app-deploy-viewer.log
+
+3.2 Automatisch deployen via Gitea hook
+
+In Gitea (repo Tour/viewer):
+
+Ga naar Instellingen → Git Hooks
+
+Kies post-receive
+
+Gebruik:
+
+#!/usr/bin/env bash
+/usr/local/bin/app-deploy viewer
+
+
+Vanaf nu:
+
+Elke git push naar Tour/viewer triggert automatisch een deploy.
+
+4. Traefik & DNS
+
+Traefik draait in de traefik stack op dezelfde server en beheert:
+
+git.appmodel.nl
+
+auction.appmodel.nl
+
+aupi.appmodel.nl
+
+… (nieuwe apps via labels)
+
+Nieuwe app viewer krijgt via apps-create al de juiste labels:
+
+labels:
+  - "traefik.enable=true"
+  - "traefik.http.routers.viewer.rule=Host(`viewer.appmodel.nl`)"
+  - "traefik.http.routers.viewer.entrypoints=websecure"
+  - "traefik.http.routers.viewer.tls=true"
+  - "traefik.http.routers.viewer.tls.certresolver=letsencrypt"
+  - "traefik.http.services.viewer.loadbalancer.server.port=80"
+
+
+Je moet alleen in DNS nog een record maken:
+
+viewer.appmodel.nl → publieke IP van de server
+
+Traefik + Let’s Encrypt regelen het certificaat automatisch.
+
+5. Nieuwe app types (toekomst)
+
+Het apps-create script ondersteunt nu:
+
+static-fe – Node build → Nginx → static frontend
+
+Later kun je extra types toevoegen, bijvoorbeeld:
+
+api-py – Python (Flask/FastAPI) API
+
+worker-py – background worker / crawler
+
+Door per type een eigen Dockerfile-sjabloon en standaard docker-compose.yml te genereren, wordt een nieuw project neerzetten:
+
+apps-create stats api-py
+apps-create crawler worker-py
+
+
+en blijft de pipeline (app-deploy <naam>) identiek.
+
+Je kunt nu:
+
+apps-create viewer static-fe
+app-deploy viewer