Upgrade

DB-Migrationen sind idempotent und laufen automatisch beim API-Start.

Zero-Downtime-Upgrade

  1. Starten Sie die neue Version parallel (zum Beispiel über blue/green hinter nginx)
  2. Health-Check: GET /healthzok nach den Migrationen
  3. Leiten Sie den Traffic auf die neue Version
  4. Die alte bleibt für einen 24-48-Stunden-Rollback

Rollback

Migrationen sind forward-only (wir schreiben keine Downgrades). Ein Backend-Rollback ist nur möglich, wenn die neue Migration den alten Code nicht gebrochen hat (wir vermeiden drop column / type change in einer Version). Für Major-Versionen — vor dem Upgrade ein Backup.