Rolle `vaultwarden_restore`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/vaultwarden_restore.md
Rolle vaultwarden_restore
Wiederherstellung der Vaultwarden-Daten aus dem NAS-Backup.
| Läuft gegen | controlplane-0 |
| Tags | vaultwarden-restore |
| Quellcode | roles/vaultwarden_restore |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
vaultwarden_namespace |
vaultwarden |
– |
vaultwarden_release |
vaultwarden |
– |
vaultwarden_restore_image |
alpine:3.20 |
– |
force_restore |
false |
– |
Ablauf
- Restore ohne force_restore=true ablehnen
- Vaultwarden-Deployment auf 0 Replicas skalieren
- Warten bis der Vaultwarden-Pod terminiert ist
- restore-job ausfuehren und vaultwarden danach immer wieder starten (Block)
- Eventuellen Restore-Job aus einem vorherigen Lauf entfernen
- Restore-Job-Manifest rendern
- Restore-Job anwenden
- Warten bis der Restore-Job abgeschlossen ist
- bei Fehler: logs des fehlgeschlagenen restore-jobs lesen, fehlgeschlagenen restore melden
- immer: Gerendertes Job-Manifest wieder entfernen, Vaultwarden-Deployment wieder auf 1 Replica skalieren
- Warten bis Vaultwarden wieder Ready ist
- Erreichbarkeit nach dem Restore pruefen (/alive)
Templates
restore-job.yaml.j2
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
kubectl -n vaultwarden get pods,pvc,job
kubectl -n vaultwarden logs job/vaultwarden-restore
make vaultwarden-restore FORCE_RESTORE=true # in capulus-ansible, überschreibt Live-Daten
| Symptom | Ursache | Lösung |
|---|---|---|
Sicherheitsabbruch: dieser Lauf wuerde die aktuellen Daten … ueberschreiben … |
Restore ohne force_restore=true |
nur bei frischem Redeploy oder Disaster Recovery mit -e force_restore=true starten |
| Restore-Job bleibt hängen oder scheitert | NAS-Backup-PVC nicht gebunden, Datei nicht vorhanden | kubectl describe job, NAS-Backup |
Vaultwarden antwortet danach nicht (/alive) |
Daten unvollständig, Pod startet nicht | kubectl -n vaultwarden logs deploy/vaultwarden, Vaultwarden |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.