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.

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.

| Feld | Bedeutung |
|---|---|
| Release-ID | eindeutiger Name, z. B. 4.2.0. Beim ersten Release über das Plus-Symbol vorbelegt mit baseline-JJJJ-MM-TT |
| Vorgänger | Baseline (kein Vorgänger) oder ein vorhandener Release. Vorbelegt mit dem neuesten Release der Linie main |
| Release-Linie | Standard main, oder ein Name für eine Kundenvariante |
| Migrations-SQL | das SQL vom Vorgänger zu diesem Stand |
| SQL entwerfen | Migrationsentwurf erzeugen, siehe unten |
| Schild-Symbol Betriebsplan und Prüfungen | Phase, Zeitlimits und Datenprüfungen, siehe unten |
| Release-Datei anlegen | schreibt 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
| Regel | Meldung |
|---|---|
Release-ID und Release-Linie: Buchstaben, Ziffern, ., -, _; erstes Zeichen Buchstabe oder Ziffer; höchstens 100 Zeichen | Release-ID: Buchstaben, Ziffern, Punkt, Bindestrich oder Unterstrich verwenden. |
| ID noch nicht vergeben | Release-ID existiert bereits. Einen neuen Release anlegen. |
| Nur eine Baseline pro Linie | Für diese Release-Linie existiert bereits eine Baseline. Einen Vorgänger auswählen. |
| Baseline ohne SQL | Eine Baseline erfasst den bestehenden Stand. SQL erst im nächsten Release hinzufügen. |
| Nachfolger mit SQL | Ein Update-Release benötigt eine geprüfte Migration. |
| Mindestens ein aufgenommenes Objekt | Zuerst mindestens ein Objekt aufnehmen. |
Kundenvariante wechselt nicht in eine fremde Linie. Vorgänger muss auf main oder derselben Linie liegen | Eine Kundenvariante darf nicht in eine fremde Release-Linie wechseln. |
| Committete Releases sind unveränderlich | Commitete 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.

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