InnerWeb
Zum Inhalt springen

Datenbankmigrationen beim Update des Systems: Hinweise zur Umsetzung

Ein Update des Systems ist nicht nur ein neues Container-Image, sondern auch Datenbankmigrationen, die die Datenstruktur verändern. Bei einer Installation mit langer Versionshistorie muss jede Migration mit dem Zustand klarkommen, den die jeweilige Installation tatsächlich hat. Im Folgenden finden Sie eine Checkliste für den Administrator: was vor dem Start zu prüfen ist, wie sich die Dauer des Fensters berechnet und welche Regeln der Hersteller anwendet.

6
Installationen, auf deren Kopien die Migrationen geprüft wurden
Quelle: Karte
3 bis 32 s
Bereich der Laufzeit der Migrationen auf diesen Kopien
Quelle: Karte
380
Migrationen in der Kette beim Start von einer leeren Datenbank
Quelle: Karte

Was eine Migration ist und warum sie riskant sein kann

Eine Migration ist ein Skript, das die Struktur der Datenbank verändert: Es fügt eine Spalte hinzu, legt eine Tabelle an oder ändert einen Index. Die neue Version der Anwendung setzt voraus, dass die Migrationen ausgeführt wurden. Ihr Abbruch mitten im Vorgang hinterlässt das System in einem Zustand, in dem die Software nicht zur Datenbank passt. Besonders gefährdet sind Installationen mit langer Versionshistorie, weil sie viele Änderungen durchlaufen haben und sich in Kleinigkeiten voneinander unterscheiden können.

Deshalb behandelt der Hersteller Migrationen wie Produktivcode und prüft sie an Kopien echter Installationen. Der Administrator hat zusätzliche Schritte vor dem Start.

Regeln für das Schreiben von Migrationen auf Seiten des Herstellers

Wir haben vier Regeln festgelegt. Migrationen verwenden innerhalb des Skripts kein ORM, weil die Abbildung der Objekte vom aktuellen Code abhängt und nicht vom historischen Zustand der Datenbank. Jede Anweisung ist so abgesichert, dass sie für Installationen mit unterschiedlicher Historie funktioniert und nicht voraussetzt, dass eine Spalte oder ein Index bereits existiert oder noch nicht existiert. Ausnahmen werden eng abgefangen, damit ein echter Fehler nicht in einer allgemeinen Behandlung verschwindet. Schließlich gilt das Verbot, Migrationen zu überspringen: Eine übersprungene Migration bleibt dauerhaft ausstehend und taucht bei jedem folgenden Update wieder als Problem auf.

Eine CI-Aufgabe führt bei jeder Änderung die gesamte Kette der Migrationen auf einer leeren Datenbank aus und verlangt, dass die Datenbank mit dem Code übereinstimmt. Das prüft den Weg von Grund auf, ersetzt aber nicht den Versuch auf einer Kopie einer Datenbank mit langer Historie.

  • kein ORM innerhalb der Migrationen
  • Absicherung jeder Anweisung für Installationen mit unterschiedlicher Historie
  • eng gefasste Behandlung von Ausnahmen
  • Verbot, Migrationen zu überspringen

Bereich der Laufzeit der Migrationen auf Produktionskopien

Bereich der Laufzeit der Migrationen auf ProduktionskopienSäulendiagramm: Die kürzeste Migration dauerte 3 Sekunden, die längste 32 Sekunden auf den Kopien von sechs Installationen.010203040SekundenKürzeste: 3 Sekunden3KürzesteLängste: 32 Sekunden32Längste
Quelle: Karte: Versuch auf Produktionskopien von sechs Installationen (3 bis 32 s)

Versuch auf Produktionskopien: Zeiten, die wir kennen

Die Migrationen wurden auf Produktionskopien von sechs Installationen mit dem Code des neuen Zweigs geprüft. Jeder Lauf endete erfolgreich, und die Laufzeit schwankte zwischen einigen Sekunden und einigen Dutzend Sekunden, konkret im Bereich von 3 bis 32 s. Das sind Zeiten für bestimmte Migrationen und bestimmte Datenbankgrößen, bei einer anderen Änderung können sie abweichen.

Die praktische Folgerung: Rechnen Sie im Wartungsfenster eine Reserve ein, die ein Vielfaches der längsten gemessenen Zeit beträgt, und messen Sie auf der eigenen Installation die Zeit auf einer Kopie auf der Vorproduktion.

Was vor dem Start auf der Produktion zu prüfen ist

Die Reihenfolge der Schritte ist wichtiger als die Befehle selbst. Beginnen Sie mit der Sicherung, dann die Vorproduktion, dann das Fenster auf der Produktion.

  • Aktuelle Sicherung der Datenbank und des Dateispeichers, unmittelbar vor dem Fenster erstellt.
  • Sicherung auf der Vorproduktion wiederhergestellt und geprüft.
  • Migrationen auf der Vorproduktion mit der neuen Codeversion ausgeführt, Laufzeit notiert.
  • Freier Speicherplatz auf der Platte größer als die Größe der größten Tabelle.
  • Liste der ausstehenden Migrationen mit der Liste aus der Sicherung verglichen, ohne übersprungene.
  • Rückfallplan: Sicherung griffbereit und eine Person, die sie wiederherstellt.

Fallstricke, die wir in der Praxis gesehen haben

Erstens: eine Kette von Migrationen, die bei der siebten Migration einer frischen Datenbank abbrach. Das fiel erst beim Versuch eines Starts von Grund auf auf, daher haben wir der CI eine Aufgabe hinzugefügt, die dies bei jeder Änderung prüft. Zweitens: die Annahme, dass alle Installationen gleich aussehen, was bei langer Versionshistorie nicht zutrifft. Drittens: parallel zu den Migrationen gestartete schwere Aufgaben, die um Arbeitsspeicher und Platte konkurrieren.

Zum Vergleich: Der Start einer sauberen Umgebung von einer leeren Datenbank bis zur funktionierenden Anmeldung dauerte im Test etwa 8 Minuten, vor allem wegen der Ausführung von 380 Migrationen. Das ist jedoch die Zeit für eine Installation ohne Historie und ohne Daten, nicht für die Produktion.

Videomaterial

Häufig gestellte Fragen

Wie lange dauern die Migrationen beim Update?

Auf Produktionskopien von sechs Installationen zwischen 3 und 32 Sekunden. Messen Sie auf Ihrer Installation die Zeit auf der Vorproduktion, denn sie hängt von der Größe der Datenbank ab.

Kann man eine fehlgeschlagene Migration überspringen?

Nein. Eine übersprungene Migration bleibt dauerhaft ausstehend. Die Ursache ist festzustellen, zu beheben und die Migration erneut auszuführen.

Wozu der Versuch auf der Vorproduktion, wenn die CI die Migrationen prüft?

Die CI prüft den Weg von einer leeren Datenbank, die Vorproduktion dagegen den Zustand einer Installation mit langer Historie und die reale Größe der Daten.

Schafft eine ältere Installation das Update?

Die Migrationen sind für Installationen mit unterschiedlicher Historie abgesichert, entscheidend ist aber der Versuch auf einer Kopie der konkreten Installation.

Quellen

Planen wir das Update gemeinsam mit der IT

Gemeinsam legen wir die Reihenfolge fest: Sicherung, Versuch der Migration auf der Vorproduktion und Fenster auf der Produktion mit Rückfallplan.

Sprechen wir