So trennst du Datenbankmigrationen beim Container-Rollout vom App-Start ab

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Doppelte Datenbankmigrationen lassen sich leichter verhindern, wenn Schemaänderungen als einzelner, expliziter Deployment-Schritt statt beim Start jedes Anwendungskontainers ausgeführt werden.

Beim vorbeugenden Design gibt es für Migrationen genau einen Ausführungsverantwortlichen, einen Satz Zugangsdaten und ein Abschlusssignal, bevor neue Replikate Anfragen bedienen. Web- und Worker-Kontainer müssen sich ohne Berechtigungen für Schemaänderungen neu starten lassen. Das Rollout muss auf einen erfolgreichen Migrationsjob warten, und Schemaänderungen müssen so gestaltet sein, dass alte und neue Anwendungsversionen kurzzeitig parallel bestehen können. So wird die Wettlaufsituation beseitigt, statt nur zu hoffen, dass jedes Replikat zuerst dieselbe Migrationshistorie erkennt.

Migrationsbefehle aus dem normalen Anwendungsstart entfernen

Prüfe den Image-Einstiegspunkt, den Compose-Befehl, den Worker-Befehl, den Health-Wrapper und das Deployment-Skript auf automatische Migrationsaufrufe. Die Anwendung sollte neu gestartet werden können, ohne das Schema zu ändern, es sei denn, der Neustart ist der bewusst gewählte Migrationsschritt.

Ein Deployment-Artikel von Octopus argumentiert, dass Migrationen einen eigenen Lebenszyklus brauchen, statt an jeden Start eines Microservice-Prozesses gekoppelt zu sein.

Halte die Migrationsbinärdatei dort verfügbar, wo sie gebraucht wird, rufe sie aber nicht sowohl im Web-Einstiegspunkt als auch in einem zweiten Job auf. Ein klar festgelegter Ausführungsverantwortlicher lässt sich leichter überprüfen als mehrere Startpfade, die alle von der Framework-Sperre abhängen.

Einen einzelnen Migrationsjob vor dem Deployment ausführen

Erstelle einen einmaligen Job, der dieselben Migrationsdateien wie das Release verwendet und erst dann erfolgreich beendet wird, wenn die Zieldatenbank den erwarteten Schemazustand erreicht hat. Lass das Anwendungs-Rollout von diesem Ergebnis abhängen.

Ein aktueller Rollout-Leitfaden zeigt, wie ein einzelner Job vor dem Rollout ausgeführt wird, statt dass jedes Replikat beim Start einen Wettlauf beginnt.

Skaliere die Migrationsaufgabe nicht wie den Anwendungsdienst. Der Job sollte pro Zieldatenbank genau einen Ausführungsverantwortlichen, ein begrenztes Zeitlimit, Protokolle und einen eindeutigen Fehlerstatus haben, der die neue Anwendungsversion blockiert.

Anwendungsstart erst nach erfolgreicher Migration

Lass neue Web- und Worker-Kontainer warten, bis die Migrationsphase Erfolg meldet. Die wartenden Kontainer dürfen die Migration jedoch nicht selbst erneut ausführen. Die Abhängigkeit bezieht sich auf das Ergebnis, nicht auf eine erneute Ausführung der Schemaänderung.

Das Deployment-Muster von Andrew Lock verwendet App-Pods, die auf die Migration warten, während die Migrationslogik zentral bleibt.

Bei einem kleinen Home-Server-Stack lässt sich dasselbe Prinzip mit einem dedizierten Compose-Dienst und einem kontrollierten Bereitstellungsskript umsetzen. Halten Sie den Mechanismus so einfach, dass eine fehlgeschlagene Migration den Rollout sichtbar stoppt.

Verwenden Sie während der Übergangsphase abwärtskompatible Schemaänderungen

Bei schrittweisen Bereitstellungen können vorübergehend alte und neue Anwendungsversionen auf dieselbe Datenbank zugreifen. Vermeiden Sie Migrationen, die ein Feld entfernen oder umbenennen, solange die alte Version es noch verwendet.

Ein aktueller Leitfaden zu Migrationen ohne Ausfallzeiten empfiehlt: erst erweitern, dann einschränken, damit additive Schemaänderungen vor dem Entfernen alter Strukturen eingeführt werden.

Teilen Sie umfangreiche Änderungen bei Bedarf in die Phasen Erweitern, Auffüllen, Umschalten und Entfernen auf. Der Migrationsjob sollte kein Schema erstellen, das nur der neue Container versteht, solange alte Replikate noch Anfragen bearbeiten.

Halten Sie Migrationszugangsdaten von App-Replikaten fern

Verwenden Sie nach Möglichkeit ein Datenbankkonto mit Schemaänderungsrechten nur für die einmalige Migrationsphase. Normale App-Container sollten lediglich die eingeschränkten Lese- und Schreibberechtigungen für Anwendungsdaten erhalten.

Ein Liquibase-Bereitstellungsartikel erklärt, dass Datenbankänderungen in die Automatisierung gehören, damit sie kontrolliert und wiederholbar angewendet werden.

Durch diese Trennung ist es weniger wahrscheinlich, dass Migrationen versehentlich ausgeführt werden, selbst wenn ein App-Prozess neu gestartet oder dupliziert wird. Speichern Sie die Zugangsdaten mit erweiterten Berechtigungen im Secret-Pfad der Bereitstellung statt in der Umgebung des regulären, dauerhaft laufenden Dienstes.

Überprüfen Sie, dass der Rollout den Änderungssatz nicht zweimal anwenden kann

Testen Sie die Bereitstellung in einer temporären Datenbank oder einem wiederhergestellten Snapshot, indem Sie mehrere App-Replikate starten, neu starten und den Bereitstellungsbefehl erneut ausführen. Die Migrationsphase sollte den vorhandenen Schema-Status melden, ohne ihn ein zweites Mal zu ändern.

JetBrains fasst die Betriebsregel so zusammen: Migrationen als Bereitstellungsschritt ausführen, bevor die Anwendung normal gestartet wird.

Die Präventionsrichtlinie ist vollständig, wenn App-Neustarts das Schema nicht verändern können, eine fehlgeschlagene Migration die Veröffentlichung blockiert und wiederholte Rollouts die Datenbank unverändert lassen. Der zugehörige ZimaSpace-Artikel zur Diagnose doppelter Migrationen beschreibt den Wiederherstellungsweg, falls eine Migration bereits doppelt ausgeführt wurde.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.