Add service removal checklist after stale Borg source finding
Befund vom 2026-05-29: HomelabBorgLastJobCompletedWithWarnings zuendete vier Tage in Folge mit Borg-Exit-Code 107. Ursache im Logfile: /local/appdata/homepage wurde am 25.05. entfernt, aber in der Borg-UI-Source-Liste blieb der Eintrag drin und Borg warnte taeglich BackupFileNotFoundError. Backups selbst waren nicht gefaehrdet (alle 23 anderen Quellen sauber archiviert). Operator hat den Eintrag in der Borg-UI manuell entfernt; Source-Liste jetzt 23 statt 24, naechster Lauf 2026-05-30 sollte wieder completed ohne Warning sein. Erkenntnis: bei Stack-Removal wurde die Borg-Source-Liste nicht mit-aufgeraeumt. WORKFLOW.md um neuen Abschnitt "Service-Removal- Checkliste" erweitert mit 9 Pflichtschritten inklusive Borg-UI-Source-Bereinigung als Schritt 8. Positiv: die am 2026-05-27 scharfgeschaltete Alert-Pipeline (Cron Textfile -> node-exporter -> Prometheus -> Alertmanager -> ntfy-Bridge) hat den Drift binnen 24 h sichtbar gemacht. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -311,6 +311,26 @@ dns:
|
||||
|
||||
---
|
||||
|
||||
## Service-Removal-Checkliste
|
||||
|
||||
Wenn ein Stack endgueltig entfernt wird (Beispiele: Homepage am 2026-05-25, Uptime-Kuma am 2026-05-25, Jellyfin am 2026-05-25), muss in **einem** Aenderungsblock auch der gesamte Sicht-/Backup-Pfad nachgezogen werden, sonst entstehen "Tote-Pfad-Warnings", die erst Tage spaeter auftauchen.
|
||||
|
||||
Pflicht-Schritte vor dem Schliessen:
|
||||
|
||||
1. Komodo: Stack stoppen, destroy, Stack-Eintrag loeschen.
|
||||
2. Gitea-Webhook fuer den Stack deaktivieren.
|
||||
3. Repo-Pfad per `git rm` entfernen.
|
||||
4. Appdata nach `/mnt/user/appdata/_archive/<name>-removed-YYYY-MM-DD/` verschieben (14 Tage Karenz).
|
||||
5. DNS-Eintrag im Cloudflare entfernen, sofern Public-Domain.
|
||||
6. Authelia ACL-Eintrag in `security/authelia/configuration.yml` und auf dem Host bereinigen.
|
||||
7. Monitoring: Blackbox-Target in `monitoring/blackbox/blackbox.yml` entfernen, Cert-Check-Liste pruefen.
|
||||
8. **Borg-UI Source-Liste**: `https://borg.kaleschke.info` -> Repository `appdata-critical` -> Source Directories -> alle `/local/appdata/<name>` und ggf. `/local/<name>`-Eintraege loeschen. Sonst kommen daily `HomelabBorgLastJobCompletedWithWarnings`-Push-Nachrichten mit `BackupFileNotFoundError` im Logfile.
|
||||
9. `docs/SERVICE_CATALOG.md`, `docs/REPO_MAP.md`, `HOMELAB_ARCHITECTURE_MASTER_V2.md` Sektion 7.8 (Entfernt), `docs/MIGRATION_LOG.md` nachziehen.
|
||||
|
||||
Wenn ein Stack `webhook_enabled` in Komodo hatte, zusaetzlich pruefen, ob der zugehoerige Gitea-Hook deaktiviert oder geloescht wurde.
|
||||
|
||||
---
|
||||
|
||||
## Dokumentationspflicht
|
||||
|
||||
Nach jeder erfolgreichen Migration oder relevanten Aenderung muessen diese Dateien geprueft werden:
|
||||
|
||||
Reference in New Issue
Block a user