Migrationen in der Administration
Migrationen sind Änderungen an einer Installation, einmal als Dateien geschrieben und auf jede Installation der Site in
derselben Reihenfolge angewendet (Migrationen). Die Administration zeigt und führt sie in
Setup > Migrationen aus (das Modul migration) und zeigt ihren Stand in einem Dashboard-Block und in der
Website-Seitenleiste.
Inhalt
Die Seiten
| Seite | Adresse | Wobei sie hilft | Hilfe |
|---|---|---|---|
| Stand | /migration/status | jede Migration und ihren Zustand sehen, die Sperre, die letzten Läufe | Stand und Verlauf |
| Verlauf | /migration/history | jeder Lauf mit seinen Sicherungspunkten, Commit, Tag und Push; fortsetzen und zurücknehmen | Der Verlauf |
| Die Seite eines Laufs | /migration/log/<run-id> | seine Aufzeichnung, seine Migrationen, sein Laufprotokoll und sein Fortschritt, solange er läuft | Die Seite eines Laufs |
| Probelauf | /migration/dryrun | was ein Lauf ändern würde; Simulieren führt ihn in einer Transaktion aus, die zurückgerollt wird | Probelauf |
| Ausführen | /migration/run | die ausstehenden Migrationen ausführen, einzeln ausgewählt | Ausführen |
| Rücknahme | /migration/rollback/<target> | einen Lauf, eine Migration oder einen früheren Sicherungspunkt zurücknehmen | Zurücknehmen |
| Aufzeichnung | /migration/recording, /migration/recording/<id> | von Hand gemachte Änderungen aufzeichnen, ein Fenster für die ganze Website, Migration erzeugen | Änderungen aufzeichnen |
| Redaktion (Editor) | /migration/editor, /migration/editor/<migration-id> | eine YAML-Migration mit Formularen schreiben, prüfen, ansehen, speichern | Der Migrationseditor |
| Gegenstellen | /migration/remotes, /migration/remote/<id> | die Installationen, an die diese ihre Migrationen ausliefert: der Assistent, Verbindung testen | Eine Gegenstelle anlegen, Schritt für Schritt |
| Deploys | /migration/deploy, /migration/deployment/<deploy-id> | an Gegenstellen ausliefern, gleichzeitig oder Stufe für Stufe, jede Gegenstelle live verfolgen, der Verlauf, ein Tor, eine Rücknahme | Ausliefern, Schritt für Schritt |
| Dashboard-Block | das Dashboard | ausstehend, fehlgeschlagen, verwaist, der laufende und der letzte Lauf | Der Dashboard-Block |
| Website-Seitenleiste | die Seiten der Site | derselbe Stand, nur lesend | Migrationen in der Website-Seitenleiste |
Der Stand listet außerdem zuerst die Upgrade-Schritte des Kernels, als Migrationen der Quelle kernel: Ein Lauf führt
die ausstehenden der Stufen database und scripts vor den Migrationen der Site aus
(Die Schritte unter den Migrationen).
Wer was darf
| Richtlinie | Erlaubt |
|---|---|
migration/read | den Stand, den Verlauf, die Seite eines Laufs, den Probelauf, den Dashboard-Block |
migration/run | Ausführen, Fortsetzen und das Simulieren im Probelauf |
migration/rollback | einen Lauf, eine Migration oder einen früheren Sicherungspunkt zurücknehmen |
migration/edit | die Seite Aufzeichnung und Migration erzeugen, und der Migrationseditor |
migration/remotes | die Gegenstellen anlegen, ändern und entfernen, an die Deploys gehen, und ihre Verbindung testen |
migration/deploy | an Gegenstellen ausliefern, das Tor eines Deploys in Stufen freigeben, einen Deploy zurücknehmen |
In einer neuen Installation hat sie nur die Rolle Administrator. Ausführen, Fortsetzen, Simulieren und Zurücknehmen fragen zuerst nach „Identität bestätigen“. Die Richtlinien im Einzelnen: Richtlinien des Moduls migration; jede Ansicht, Richtlinie und jedes Ereignis an einer Stelle: Richtlinien, Ansichten und Ereignisse.
Hier gestartete Läufe
Ein Lauf, eine Fortsetzung oder eine Rücknahme, die in der Administration gestartet wird, läuft im Hintergrund: Die
Seite startet den Konsolenbefehl (exp:migration:migrate --apply, exp:migration:resume --apply oder
exp:migration:rollback --apply) als eigenen Prozess unter dem angemeldeten Benutzer und öffnet die Seite des Laufs,
die ihn live verfolgt. Der Lauf geht weiter, wenn die Seite geschlossen wird. Seine Dateien liegen in
var/<site>/migration/jobs/. Er braucht proc_open und ein PHP-Kommandozeilenprogramm
(migration.ini [AdminSettings] PhpCliPath); fehlen sie, sagt die Seite das, und die Konsole führt ihn aus. Ein Lauf
zur Zeit: Solange einer läuft oder exp:upgrade oder ein anderer Lauf die Sperre der Installation hält, lehnt die Seite
einen neuen ab.
Was auf der Konsole geschieht
Migrationen sind Dateien in migrations/ (oder extension/<name>/migrations/). Die Administration schreibt
YAML-Migrationen (der Editor, eine Aufzeichnung); PHP-, SQL- und INI-Migrationen, die Generatoren aus Inhalten,
Klassen, Rollen, Sektionen, Einstellungen und Unterschieden sowie Gerüste entstehen auf der Konsole mit
./console exp:migration:generate (Migrationen erzeugen). Die Einstellungen stehen in
settings/migration.ini (Befehle, Einstellungen).
Ein Rundgang durch jede Seite mit Bildschirmfotos: Ein Rundgang durch Setup > Migrationen.
Verwandte Seiten
- Migrationen: der Einstieg, Alle Rezepte, Häufige Fragen
- Die Anleitung, das Tutorial, PHP-Migrationen, Zurücknehmen und Sicherungspunkte, Das Migrations-Repository
- Befehle, Einstellungen, Richtlinien, Ansichten und Ereignisse
- Das Dateiformat, Die Funktion
- Wenn eine Migration scheitert, Fehlermeldungen
- Migrationen oder Umzug einer Site
- Migrationen für Administratoren
- Ein Rundgang durch die Administration
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.