32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
|
# Runbooks
|
||
|
|
|
||
|
|
**Runbooks** sind Schritt-für-Schritt-Anleitungen für wiederkehrende operative Situationen — meist Notfälle oder seltene Wartungs-Aufgaben.
|
||
|
|
|
||
|
|
## Warum Runbooks?
|
||
|
|
- **Für dich selbst in 3 Monaten:** Wenn der Loco-Sync wieder kaputt ist und du dich nicht mehr an die Debug-Schritte erinnerst.
|
||
|
|
- **Für die AI:** Eine AI-Session kann ein Runbook **lesen und ausführen**, ohne dass du jede Zeile diktieren musst.
|
||
|
|
- **Für den Vertretungsfall:** Wenn du im Urlaub bist und jemand anderes dringend muss.
|
||
|
|
|
||
|
|
## Format
|
||
|
|
Jedes Runbook beschreibt:
|
||
|
|
1. **Wann anwenden** — Symptome, Trigger
|
||
|
|
2. **Voraussetzungen** — Zugänge, Tools, Secrets
|
||
|
|
3. **Schritte** — nummeriert, kopierbar (Bash-Blöcke)
|
||
|
|
4. **Verification** — wie man erkennt dass der Fix greift
|
||
|
|
5. **Was NIE machen** — typische Fallen
|
||
|
|
|
||
|
|
## Aktuelle Runbooks
|
||
|
|
|
||
|
|
### Forgejo
|
||
|
|
- **[forgejo-admin-recovery.md](forgejo-admin-recovery.md)** — Was tun wenn Authentik down ist und niemand mehr ins Forgejo kommt. Nutzt den lokalen `admin-local` Fallback-User.
|
||
|
|
- **[forgejo-backup-restore.md](forgejo-backup-restore.md)** — Backup-Format, Restore-Szenarien (komplett / nur DB / einzelne Datei), Disaster-Recovery auf neuem Server.
|
||
|
|
|
||
|
|
## Convention
|
||
|
|
- **Dateiname:** `<stack>-<action>.md`, z.B. `forgejo-backup-restore.md`, `loco-sync-debug.md`
|
||
|
|
- **Immer Bash-Blöcke** mit echten Kommandos, nicht Pseudo-Code
|
||
|
|
- **Erwartete Outputs** hinschreiben, damit man weiß wann's geklappt hat
|
||
|
|
- **Destruktive Aktionen fett markieren** ("⚠️ löscht ALLE Daten!")
|
||
|
|
|
||
|
|
## Neue Runbooks hinzufügen
|
||
|
|
Wenn du ein Problem zum zweiten Mal hast, wird es ein Runbook. Die AI kann dir das im Moment des Fixes schreiben — du reviewst im Commit.
|