From 8042639d20a6b1c115656663bb1257164cd4dac1 Mon Sep 17 00:00:00 2001 From: Claude Code Date: Sun, 26 Apr 2026 19:14:35 +0000 Subject: [PATCH] CLAUDE.md: Auto-Deploy + Promote-UI + Live-systemd dokumentiert Co-Authored-By: Claude Opus 4.7 (1M context) --- CLAUDE.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 2d442a2..ef5ec9d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -288,3 +288,60 @@ staging: - Auto-Deploy bei Push auf develop (Webhook-Listener) - Promote-UI mit Ein-Klick-Button - Live-Monitor auf systemd umstellen (~10s Downtime einmalig) + +## Auto-Deploy + Promote-UI + +```yaml +auto_deploy: + listener_service: + pfad: /opt/aegis-staging-deploy + service: aegis-staging-deploy.service + port: 127.0.0.1:8096 + deployments: + staging: develop -> ~/AegisSight-Monitor-staging (restartet aegis-monitor-staging) + live: main -> ~/AegisSight-Monitor (restartet aegis-monitor) + endpoints: + "POST /__deploy": staging via Gitea-Webhook (HMAC) + "POST /__deploy/live": live via Promote-UI (HMAC) + secrets: /opt/aegis-staging-deploy/.env (nicht im Repo) + + gitea_webhook: + repo: AegisSight/AegisSight-Monitor + url: https://staging.monitor.aegis-sight.de/__deploy + branch_filter: develop + +live_systemd: + service: aegis-monitor.service + hinweis: | + Live-Monitor laeuft seit 2026-04-26 als systemd-Service (vorher loser + uvicorn-Prozess). Manueller Restart bei Backend-Aenderungen: + sudo systemctl restart aegis-monitor + Beim Promote via UI passiert das automatisch. + +promote_ui: + url: https://deploy.aegis-sight.de + laeuft_auf: 46.225.225.49 (zentral fuer alle Services) + zugriff: Magic-Link-Login an info@aegis-sight.de + funktion: | + Live- vs. Staging-Stand pro Service inkl. Liste der ausstehenden Commits. + Promote-Knopf -> Gitea-PR develop->main wird auto-gemerged + Live-Listener + pullt main + restartet aegis-monitor. +``` + +### Vollstaendiger Workflow (Aenderung am Monitor) + +1. **Entwickeln in develop**: + ```bash + cd ~/AegisSight-Monitor-staging + git checkout develop + # Aenderung + git add . && git commit -m "..." && git push origin develop + # Auto-Deploy pullt automatisch + restartet aegis-monitor-staging + ``` + +2. **Auf https://staging.monitor.aegis-sight.de pruefen** + +3. **Promoten via https://deploy.aegis-sight.de** (Klick auf Monitor-Karte) + → Gitea merged develop→main → Listener pullt main → `systemctl restart aegis-monitor` + +4. **Live-Check auf https://monitor.aegis-sight.de**