Neu: Jede Funktion mit Schritt-für-Schritt-Anleitung und Screenshots.
Vergleichen & Versionieren

Releases

Stände mit Migrationen festhalten und für viele Datenbanken ausrollen.

Ein Release fixiert einen Definitionsstand zusammen mit der Migration, die dorthin führt. Jedes Kundenziel hat unabhängig vom Git-Branch seinen eigenen, geprüften Release-Stand.

Releases mit Vorgänger und Migrations-SQL

Reiter Releases

Die Übersicht Releases zeigt N Versionen im Repository, neueste zuerst. Jede Zeile zeigt Release-ID, Release-Linie, Anzahl Objekte und den Vorgänger (von …) bzw. Baseline. Rechts steht das Erstelldatum oder Entwurf, wenn die Release-Datei noch nicht committet ist.

Ein ausgewählter Release zeigt:

  • Anzahl Migrationen und alle Objekte als schema.objekt,
  • das Migrations-SQL oder Baseline · bestehender Ausgangsstand ohne Migration,
  • aufklappbar Betriebsplan · Phase mit Notizen, Anwendungsbetrieb, Vor- und Nachprüfungen.

Release vorbereiten

Das Plus-Symbol Release vorbereiten öffnet das Formular. Ohne Releases steht dort Der erste Stand beginnt hier mit dem Knopf Baseline vorbereiten.

Formular zum Vorbereiten eines neuen Release

FeldBedeutung
Release-IDeindeutiger Name, z. B. 4.2.0. Beim ersten Release über das Plus-Symbol vorbelegt mit baseline-JJJJ-MM-TT
VorgängerBaseline (kein Vorgänger) oder ein vorhandener Release. Vorbelegt mit dem neuesten Release der Linie main
Release-LinieStandard main, oder ein Name für eine Kundenvariante
Migrations-SQLdas SQL vom Vorgänger zu diesem Stand
SQL entwerfenMigrationsentwurf erzeugen, siehe unten
Schild-Symbol Betriebsplan und PrüfungenPhase, Zeitlimits und Datenprüfungen, siehe unten
Release-Datei anlegenschreibt database/releases/ID.json

Der Release erfasst die Definitionen aus den Dateien im Repository, nicht aus einer Datenbank. Nach dem Anlegen erscheint Release-Datei erstellt. Unter Änderungen auswählen und committen. Erst ein committeter Release kann geprüft und ausgerollt werden.

Release-Entwurf verwerfen (Papierkorb) leert das Formular. Zur Releaseübersicht ist bei ungespeichertem Entwurf gesperrt: Release-Entwurf zuerst speichern oder verwerfen.

Regeln für Releases

RegelMeldung
Release-ID und Release-Linie: Buchstaben, Ziffern, ., -, _; erstes Zeichen Buchstabe oder Ziffer; höchstens 100 ZeichenRelease-ID: Buchstaben, Ziffern, Punkt, Bindestrich oder Unterstrich verwenden.
ID noch nicht vergebenRelease-ID existiert bereits. Einen neuen Release anlegen.
Nur eine Baseline pro LinieFür diese Release-Linie existiert bereits eine Baseline. Einen Vorgänger auswählen.
Baseline ohne SQLEine Baseline erfasst den bestehenden Stand. SQL erst im nächsten Release hinzufügen.
Nachfolger mit SQLEin Update-Release benötigt eine geprüfte Migration.
Mindestens ein aufgenommenes ObjektZuerst mindestens ein Objekt aufnehmen.
Kundenvariante wechselt nicht in eine fremde Linie. Vorgänger muss auf main oder derselben Linie liegenEine Kundenvariante darf nicht in eine fremde Release-Linie wechseln.
Committete Releases sind unveränderlichCommitete Releases sind unveränderlich. Bitte einen neuen Release anlegen.

SQL entwerfen

SQL entwerfen ist nur mit Vorgänger aktiv. l8db vergleicht die aktuellen Dateien mit den Definitionen im Vorgänger-Release und erzeugt für jedes geänderte Objekt dasselbe SQL wie der Schema-Vergleich.

Betriebsplan und Prüfungen

Der Betriebsplan dokumentiert die Migration und enthält Zeitlimits sowie Vor- und Nachprüfungen.

Betriebsplan mit Phase und Zeitlimits

Für Produktionsziele gelten zusätzliche Regeln, siehe Rollout.

Weiter geht's