PKR-Lab

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

  1. Restore ohne force_restore=true ablehnen
  2. Vaultwarden-Deployment auf 0 Replicas skalieren
  3. Warten bis der Vaultwarden-Pod terminiert ist
  4. restore-job ausfuehren und vaultwarden danach immer wieder starten (Block)
    1. Eventuellen Restore-Job aus einem vorherigen Lauf entfernen
    2. Restore-Job-Manifest rendern
    3. Restore-Job anwenden
    4. 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
  5. Warten bis Vaultwarden wieder Ready ist
  6. Erreichbarkeit nach dem Restore pruefen (/alive)

Templates


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.

Alle Rollen