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
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