3efa0ee423
Aenderungen an Codeberg-Issues landeten bisher erst beim naechsten Lauf des sync-Services auf dem Board (MONITOR_SYNC_INTERVAL, Default 600s). Neu meldet Codeberg jede Aenderung aktiv per Webhook, der Weg aufs Board dauert damit wenige Sekunden (Webhook -> Sync -> SSE-Push ans Frontend). POST /api/v1/webhooks/codeberg wertet den Payload bewusst nicht aus, sondern fordert nur einen regulaeren Sync an - CodebergSyncService bleibt die einzige Stelle, die Issues auf Tickets abbildet, und ein verpasster Webhook ist folgenlos, weil der periodische Lauf denselben Stand ohnehin nachholt. Der Sync passiert nicht im Request: Forgejo bricht die Zustellung nach wenigen Sekunden ab (DELIVER_TIMEOUT, Default 5s), ein Sync macht aber mehrere Requests nach codeberg.org. Der Endpunkt setzt daher nur eine Trigger-Datei im gemeinsamen ./api-Volume (Sync\SyncTrigger) und antwortet sofort mit 202; der sync-Service laeuft jetzt im Watch-Modus und greift sie im Sekundentakt auf. Authentifiziert wird per HMAC-SHA256 ueber den rohen Request-Body (X-Forgejo-Signature bzw. X-Gitea-Signature) - Codeberg kennt unsere API-Keys nicht. Ohne gesetztes CODEBERG_WEBHOOK_SECRET weist der Endpunkt grundsaetzlich mit 401 ab, damit ein vergessenes Secret keinen offenen Sync-Ausloeser im Internet hinterlaesst. Request traegt dafuer neu den unveraenderten rawBody. Anders als der sync-Service braucht der api-Service damit eine eingehende Freigabe in Proxy und Firewall (POST /api/v1/webhooks/codeberg). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
96 lines
4.3 KiB
YAML
96 lines
4.3 KiB
YAML
services:
|
|
api:
|
|
build:
|
|
context: ./api
|
|
dockerfile: docker/Dockerfile
|
|
volumes:
|
|
- ./api:/app
|
|
# Optional: echte status.txt aus der Produktion zum Testen einbinden, z.B.
|
|
# - ./status.txt:/status.txt:ro
|
|
working_dir: /app
|
|
# Achtung: Eine Aenderung des Host-Ports muss in .env (MONITOR_API_BASE) nachgezogen
|
|
# werden - das Frontend laeuft im Browser und erreicht die API nicht ueber das
|
|
# Compose-Netzwerk, sondern ueber genau diesen Port.
|
|
ports:
|
|
- "8091:8080"
|
|
environment:
|
|
MONITOR_DB_PATH: /app/data/monitor.sqlite
|
|
MONITOR_ADMIN_API_KEY: ${MONITOR_ADMIN_API_KEY:-dev-admin-key}
|
|
MONITOR_STATUS_FILE: /status.txt
|
|
MONITOR_DESK_COUNT: 8
|
|
MONITOR_SSE_MAX_ITERATIONS: 30
|
|
MONITOR_SSE_POLL_INTERVAL: 2
|
|
MONITOR_SYNC_TRIGGER_FILE: /app/data/sync-requested
|
|
CODEBERG_API_BASE: https://codeberg.org/api/v1
|
|
CODEBERG_OWNER: ${CODEBERG_OWNER:-fds2610}
|
|
CODEBERG_REPO: ${CODEBERG_REPO:-monitor}
|
|
CODEBERG_TOKEN: ${CODEBERG_TOKEN:-}
|
|
# Secret des Codeberg-Webhooks. Ohne diesen Wert weist POST /api/v1/webhooks/codeberg
|
|
# jede Anfrage mit 401 ab - der Endpunkt ist aus dem Internet erreichbar und die
|
|
# Signatur ist sein einziger Schutz.
|
|
CODEBERG_WEBHOOK_SECRET: ${CODEBERG_WEBHOOK_SECRET:-}
|
|
|
|
# Haelt Backlog/Done aus Codeberg aktuell (F4, siehe API.md Abschnitt "Codeberg-Sync"):
|
|
# laeuft dasselbe Image wie api und teilt sich ueber das ./api-Volume dieselbe SQLite-Datei.
|
|
# Ohne diesen Service bleibt das Board leer, solange kein Agent selbst Tickets meldet.
|
|
#
|
|
# Der Watch-Modus laeuft aus zwei Gruenden: periodisch alle MONITOR_SYNC_INTERVAL Sekunden
|
|
# und sofort, wenn der api-Container ueber die Trigger-Datei einen Codeberg-Webhook
|
|
# weiterreicht (siehe Sync\SyncTrigger). Mit funktionierendem Webhook ist das Intervall nur
|
|
# noch das Sicherheitsnetz fuer verpasste Zustellungen und darf deshalb gross sein.
|
|
#
|
|
# Dieser Service selbst baut weiterhin nur ausgehende Verbindungen auf und braucht kein
|
|
# Port-Mapping. Die eingehende Freigabe betrifft ausschliesslich den api-Service, ueber den
|
|
# Codeberg den Webhook zustellt.
|
|
sync:
|
|
build:
|
|
context: ./api
|
|
dockerfile: docker/Dockerfile
|
|
volumes:
|
|
- ./api:/app
|
|
working_dir: /app
|
|
restart: unless-stopped
|
|
depends_on:
|
|
- api
|
|
environment:
|
|
MONITOR_DB_PATH: /app/data/monitor.sqlite
|
|
MONITOR_SYNC_INTERVAL: ${MONITOR_SYNC_INTERVAL:-600}
|
|
MONITOR_SYNC_TRIGGER_FILE: /app/data/sync-requested
|
|
CODEBERG_API_BASE: https://codeberg.org/api/v1
|
|
CODEBERG_OWNER: ${CODEBERG_OWNER:-fds2610}
|
|
CODEBERG_REPO: ${CODEBERG_REPO:-monitor}
|
|
CODEBERG_TOKEN: ${CODEBERG_TOKEN:-}
|
|
command: php bin/sync-codeberg.php --watch
|
|
|
|
# Statisches Frontend (html/) - Phase 2 der Neuausrichtung (Buero-Visualisierung).
|
|
# Nur zur lokalen Ansicht/Entwicklung, kein Build-Schritt noetig (Vanilla HTML/CSS/JS).
|
|
web:
|
|
image: nginx:alpine
|
|
volumes:
|
|
- ./html:/usr/share/nginx/html:ro
|
|
# Ueberlagert den Platzhalter html/API.md - der muss existieren, weil in
|
|
# einem read-only gemounteten Verzeichnis kein Mountpoint angelegt werden kann.
|
|
- ./API.md:/usr/share/nginx/html/API.md:ro
|
|
# Setzt office.html als Einstiegsseite (sonst 403 auf der Basis-URL) und liefert
|
|
# /config.js aus. Als Template gemountet, damit das nginx-Image beim Start
|
|
# MONITOR_API_BASE per envsubst einsetzt (Ausgabe: /etc/nginx/conf.d/default.conf).
|
|
- ./docker/nginx/default.conf.template:/etc/nginx/templates/default.conf.template:ro
|
|
environment:
|
|
# Wird in docker/nginx/default.conf.template eingesetzt und als /config.js an den
|
|
# Browser ausgeliefert. Leer = gleicher Origin (relatives /api/v1).
|
|
MONITOR_API_BASE: ${MONITOR_API_BASE:-}
|
|
# Speist nur den kosmetischen Reload-Countdown im Header (Issue #12) - gleicher
|
|
# Default wie beim sync-Service oben, damit die Anzeige zur tatsaechlichen
|
|
# Sync-Frequenz passt, wenn MONITOR_SYNC_INTERVAL nicht gesetzt ist.
|
|
MONITOR_SYNC_INTERVAL: ${MONITOR_SYNC_INTERVAL:-600}
|
|
ports:
|
|
- "8090:80"
|
|
|
|
# Fuehrt die Node-basierten Frontend-Tests (tests/frontend/) aus. Node/npm sind nur im
|
|
# Container noetig, nicht auf dem Host (analog zum api-Service mit PHP/Composer).
|
|
frontend:
|
|
image: node:20-alpine
|
|
working_dir: /app
|
|
volumes:
|
|
- .:/app
|
|
command: npm test
|