Runbook: Backup und Restore

PRX-26. Owner (provisorisch): Elena Weiss (DevOps/Platform Lead).

Geltungsbereich

Betrifft ausschließlich die Datenbank procurex_db in der geteilten enterprise-infrastructure-Postgres-

Instanz. PROCUREX-Anwendungscontainer selbst sind zustandslos (kein PersistentVolume), daher kein

Anwendungs-Backup nötig.

Backup

docker exec -e PGPASSWORD=<passwort> shared-postgres pg_dump --username procurex_user \
  --dbname procurex_db --format=custom --file=/tmp/procurex_db.dump
docker cp shared-postgres:/tmp/procurex_db.dump ./procurex_db_$(date +%Y%m%d).dump

Restore

docker cp ./procurex_db_<datum>.dump shared-postgres:/tmp/procurex_db.dump
docker exec -e PGPASSWORD=<admin-passwort> shared-postgres pg_restore --username admin \
  --dbname procurex_db --clean --if-exists /tmp/procurex_db.dump

Wichtig: --dbname procurex_db, niemals --dbname postgres (das ist die Bootstrap-Datenbank

der geteilten Instanz, siehe shared/enterprise-infrastructure/postgres/init-project-databases.sh — ein Restore

gegen die falsche Datenbank würde andere Lernprojekte gefährden, siehe Risiken unten).

Testnachweis: Nicht live durchgeführt in dieser Runde (kein Testdatenbestand vorhanden, alle

Tabellen sind aktuell leer). Befehle basieren auf dem in shared/enterprise-infrastructure/README.md dokumentierten

Zugriffsmuster (siehe procurex-app/README.md, Abschnitt "enterprise-infrastructure anbinden") und wurden

gegen die reale Instanz nur für DB/User-Anlage (nicht Backup/Restore) verifiziert.

Risiken

Die Postgres-Instanz ist geteilt mit anderen Lernprojekten (aktuell nur keycloak_db

zusätzlich zu procurex_db). Ein docker compose down -v auf enterprise-infrastructure würde alle

Projekte gleichzeitig betreffen — niemals ohne Rücksprache ausführen (siehe Confluence Seite 12,

Betriebsregeln).

Kein automatisiertes/geplantes Backup eingerichtet — rein manueller Prozess, Lernprojekt-Status.

Eskalation

Restore schlägt fehl oder Datenintegrität fraglich: Incident-Runbook (incident.md) folgen,

zusätzlich Rücksprache vor jeder Aktion, die andere Projekte in enterprise-infrastructure betreffen könnte.