diff --git a/docs/ROLLBACK.md b/docs/ROLLBACK.md index e69de29..a66abd6 100644 --- a/docs/ROLLBACK.md +++ b/docs/ROLLBACK.md @@ -0,0 +1,87 @@ +# Rollback Guide — Homelab + +Dieses Dokument beschreibt, wie Änderungen rückgängig gemacht werden können. + +--- + +## Grundprinzip + +Jede Änderung muss rückrollbar sein. + +--- + +## Standard-Rollback (Git) + +### Letzten Stand anzeigen + + +git log --oneline + + +### Auf vorherigen Stand zurücksetzen + + +git reset --hard +git push --force + + +--- + +## Rollback über Portainer + +1. Stack öffnen +2. „Redeploy“ auswählen +3. vorherigen Commit verwenden (bei Git-Stacks) + +--- + +## Container-Rollback + +Wenn ein neuer Stack Probleme macht: + +1. neuen Container stoppen +2. alten Container wieder starten +3. Logs prüfen + +--- + +## Datenbank-Rollback + +### Backup vorhanden (empfohlen über backrest) + +Restore durchführen + +### Manuelle Sicherung + + +cp -r /mnt/user/appdata/ /mnt/user/backup/ + + +--- + +## Best Practices + +- Immer nur **eine Änderung gleichzeitig** +- Vor jeder Änderung prüfen: + - läuft Backup? + - ist der aktuelle Zustand stabil? +- Nach jeder Änderung: + - Funktion testen + - Logs prüfen +- Migration im `MIGRATION_LOG.md` dokumentieren + +--- + +## Notfallregel + +Wenn etwas unklar ist: + +- NICHT weiter ändern +- aktuellen Zustand analysieren +- gezielt und kontrolliert eingreifen + +--- + +## Ziel + +Rollback muss jederzeit möglich sein, ohne Datenverlust und ohne unnötige Downtime. \ No newline at end of file