Migrationen: häufige Fragen
Inhalt
- Die Idee
- Migrationen schreiben
- Migrationen ausführen
- Sicherheit und der Weg zurück
- Teams, Umgebungen und Auslieferung
- In der Administration
- Datenbanken
- Umstieg von anderen Werkzeugen
- Verwandte Seiten
Die Idee
Was ist eine Migration? Eine Änderung an einer Installation (eine Tabelle, eine Spalte, eine Inhaltsklasse, Inhalte, eine Rolle, eine Einstellung) in einer PHP-Datei unter Versionskontrolle, einmal auf jede Installation einer Site in derselben Reihenfolge angewendet, mit einer Aufzeichnung, was wo gelaufen ist. Migrationen.
Ist eine Migration dasselbe wie der Umzug meiner Site zu Exponential oder auf einen anderen Server? Nein. Migrationen ändern eine Site Schritt für Schritt; eine Site migrieren heißt, eine ganze Installation umzuziehen oder zu aktualisieren. Migrationen oder Umzug einer Site.
Warum nicht einfach SQL von Hand auf jedem Server ausführen? Weil nichts festhielte, welche Anweisungen wo gelaufen sind, ein Fehler auf der Produktion keinen automatischen Weg zurück hätte und Staging und Produktion auseinanderliefen. Eine Migration läuft einmal je Installation, der Reihe nach, nach einem Sicherungspunkt, und ihre Aufzeichnung wird in Git committet. Umstieg von SQL-Update-Dateien.
Wann nehme ich einen Upgrade-Schritt statt einer Migration?
Für das, was jede Installation einer Erweiterung beim Upgrade braucht, einen Upgrade-Schritt von exp:upgrade; für eine
Änderung, die eine Site einmal macht, eine Migration. Upgrade-Schritt oder Migration?.
Brauche ich eine Migration für die Änderung eines Templates oder einer Einstellungsdatei?
Nein: Templates und Einstellungsdateien sind Code und reisen mit Git. Eine Migration ist für das, was in der Datenbank
liegt (und für settings/override, das nicht in Git ist):
INI-Einstellungen verschieben oder umbenennen.
Migrationen schreiben
Wie beginne ich eine neue?
./console exp:migration:generate --skeleton <name> --apply schreibt migrations/<zeitstempel>_<name>.php mit dem Kopf,
plan(), up() und down(). Das Tutorial.
Kann ich Migrationen in YAML oder SQL schreiben?
Ja: .yml-Dateien mit Schritten, .sql-Dateien (eine portable Datei oder eine Datei je Engine und eine
.mongodb.json) und .ini-Dateien für Einstellungen. Migrationen: SQL und Einstellungen.
Kann ich die PHP-API des Kernels in einer Migration nutzen?
Ja: eZContentFunctions, eZContentClass, eZRole, eZINI, expKernelTableSchema und der Rest, immer mit
$context->db() für die Datenbank. Migrationen in PHP schreiben.
Darf ich eine Migration ändern, nachdem sie gelaufen ist?
Nein. Ein Lauf lehnt eine Migration ab, deren Datei sich nach dem Anwenden geändert hat. Schreiben Sie eine neue
Migration für die neue Änderung; eine harmlose Bearbeitung (ein Kommentar) nehmen Sie mit --force --reason=<text> an.
Eine Migration im Code-Review prüfen.
Wie teilen zwei Migrationen einen Wert?
$context->setReference( 'name', $value ) in der einen, $context->reference( 'name' ) in einer späteren desselben
Laufs. Über Läufe hinweg finden Sie den Wert in der Installation wieder (über die Remote-ID).
PHP-Migrationen.
Braucht jede Migration ein down()? Nein. Lassen Sie es weg, wenn sich eine Änderung nicht von selbst zurücknehmen lässt (entfernte Inhalte); der Sicherungspunkt vor dem Lauf ist dann der Weg zurück. Ein umkehrbares down() schreiben.
Migrationen ausführen
Was tut exp:migration:migrate --apply, Schritt für Schritt?
Es nimmt die Sperre, prüft, ob der Code committet ist, nimmt einen Sicherungspunkt oder verwendet einen wieder, führt die
ausstehenden Migrationen der Reihe nach aus (jede in einer Transaktion, wo die Datenbank eine hat), hält beim ersten
Fehler an und stellt wieder her, nimmt nach einem erfolgreichen Lauf einen Sicherungspunkt und committet, taggt und pusht
dann die Aufzeichnung. Die Anleitung.
Kann ich zuerst sehen, was ein Lauf täte?
Ja: ./console exp:migration:migrate ohne --apply ist der Probelauf, und ./console exp:migration:dry-run --simulate --diff führt die Migrationen wirklich aus, in einer Transaktion, die zurückgerollt wird, auf PostgreSQL und SQLite.
Migrationen testen.
Kann ich Migrationen in der Administration ausführen?
Ja, unter Setup > Migrationen, mit der Richtlinie migration/run. Der Lauf geht im Hintergrund weiter, wenn Sie die
Seite schließen. In der Administration, Migrationen für Administratoren.
Unter welchem Benutzer läuft eine Migration?
In der Administration unter dem angemeldeten Benutzer; auf der Konsole als migration.ini [RunSettings] RunAsUser
(admin) oder --login=<login>. Inhalte, die sie anlegt, gehören diesem Benutzer. Einstellungen.
Was geschieht mit den Upgrade-Schritten des Kernels?
Sie werden zuerst gelistet, als Migrationen der Quelle kernel, und ein Lauf führt die ausstehenden der Stufen
database und scripts vor den Migrationen der Site aus; die anderen Stufen bleiben bei exp:upgrade.
Upgrade mit der Konsole.
Eine Migration dauert eine Stunde. Läuft sie in ein Zeitlimit?
Nicht auf der Konsole, die kein Zeitlimit hat. Schreiben Sie sie in Stapeln, die sich sicher erneut ausführen lassen, und
setzen Sie einen unterbrochenen Lauf mit exp:migration:resume --apply fort.
Große Datenmigrationen.
Sicherheit und der Weg zurück
Was ist ein Sicherungspunkt?
Ein sicherer Stand der Installation (die Datenbank, der Speicher in var/, settings/override, die Commits des Codes),
genommen vor jedem Lauf und nach einem Fehler automatisch wiederhergestellt. Im Englischen „caption“.
Sicherungspunkte und Rücknahme in der Praxis.
Wie nehme ich einen erfolgreichen Lauf zurück?
./console exp:migration:rollback <run-id> --apply stellt seinen Sicherungspunkt von vorher wieder her;
./console exp:migration:rollback <migration-id> --apply führt das down() einer Migration aus.
Zurücknehmen und Sicherungspunkte.
Verliert eine Rücknahme die Inhalte, die Redakteure nach dem Lauf geschrieben haben?
Die Wiederherstellung eines Sicherungspunkts setzt die Datenbank auf den Zeitpunkt des Sicherungspunkts zurück, also ja,
für die Datenbank. Bevorzugen Sie auf einer Site, an der Redakteure arbeiten, das down() einer Migration oder eine neue
Migration. Sicherungspunkte und Rücknahme in der Praxis.
Wer kann sehen, was wann gelaufen ist?
Setup > Migrationen > Verlauf, die Tabellen exp_migration und exp_migration_run, die Statusdatei und das
Laufprotokoll in Git und die Audit-Ereignisse system.migration.*. Die Audit-Spur der Läufe.
Teams, Umgebungen und Auslieferung
Zwei Entwickler haben gleichzeitig Migrationen angelegt. Was passiert?
Beide laufen, in der Reihenfolge ihrer Zeitstempel; braucht die eine die andere, sagt requires: das. Eine doppelte ID
oder ein Zyklus hält jeden Lauf an, bis er behoben ist. Teamarbeit mit Git.
Kann eine Migration nur auf Staging laufen, oder nie auf der Produktion?
Ja: mit der Kopfzeile environments: staging oder environments: !production.
Migrationen je Umgebung.
Wie führe ich Migrationen in meiner Deploy-Pipeline aus?
Wenn der Code an Ort und Stelle ist: ./console exp:migration:migrate --apply, dann ./console exp:velocity deploy;
Pull-Requests sichern Sie mit ./console exp:migration:check ab. Mit Migrationen ausliefern.
Wohin geht die Aufzeichnung in Git, und wer pusht sie?
Nach migrations/status/<environment>.json und migrations/runs/<run-id>.log im Repository der Site (oder einem eigenen),
committet, getaggt mit migrations/<environment>/<run-id> und vom Lauf selbst gepusht. Tags pushen.
Kann eine Erweiterung Migrationen mitbringen?
Ja, in extension/<name>/migrations/; sie laufen, solange die Erweiterung aktiv ist. Pakete tragen sie in ihrem eigenen
Ordner migrations/. Migrationen in einer Erweiterung oder einem Paket.
In der Administration
Wo fange ich in der Administration an? Unter Setup > Migrationen: seine Reiter sind Stand, Verlauf, Probelauf, Ausführen, Rücknahme, Aufzeichnung, Gegenstellen, Auslieferungen und Redaktion. Ein Rundgang durch Setup > Migrationen.
Kann ich eine Migration ohne Shell erstellen? Ja: Zeichnen Sie Ihre Änderungen auf und drücken Sie Migration erzeugen (Änderungen aufzeichnen), oder bauen Sie sie in der Redaktion (Der Migrationseditor).
Der Editor speichert meine Änderung an einer alten Migration nicht. Warum? Die Migration ist gelaufen; jede Installation, die sie angewendet hat, behält ihre Prüfsumme, und eine geänderte Datei würde dort den nächsten Lauf anhalten. Schreiben Sie die Änderung als neue Migration. Eine Migration, die gelaufen ist.
Wie lange bleibt eine Aufzeichnung für die ganze Website offen? Bis jemand sie schließt, oder so viele Minuten, wie unter Von selbst schließen nach (Minuten, optional) stehen (höchstens 31 Tage). Das Fenster für die ganze Website.
Wie füge ich Staging oder Produktion als Ziel hinzu? Setup > Migrationen > Gegenstellen > Neue Gegenstelle: fünf Schritte, die Zugangsdaten als Name eines Geheimnisses. Eine Gegenstelle anlegen, Schritt für Schritt.
Steht ein Passwort in den Einstellungen der Gegenstelle? Nie. Die Einstellungen enthalten den Namen eines Geheimnisses aus Setup > Secrets (oder eine Umgebungsvariable); ein in den Assistenten getipptes Passwort wird nicht geschrieben. Schritt 3: die Zugangsdaten.
Kann ich eine Auslieferung ausprobieren, ohne etwas zu ändern? Ja: Nur Preflight auf der Seite Auslieferungen prüft jede Gegenstelle und plant die Dateien, sendet aber nichts. Nur Preflight.
Meine Auslieferung wartet an einem Tor. Was nun? Es ist eine Auslieferung in Stufen: Prüfen Sie die ausgelieferte Stufe, dann Freigeben auf der Seite des Deploys. Deploys in Stufen und das Tor.
Was heißt „nicht im Gleichstand“? Eine Gegenstelle ist gescheitert, und nicht jede konnte zurückgenommen werden; die Gegenstellen unterscheiden sich jetzt. Im Gleichstand und nicht im Gleichstand.
Unser Host bietet nur FTP. Können wir dorthin ausliefern? Mit Nur übertragen werden die Dateien gesendet und geprüft; damit sie dort auch laufen, richten Sie den signierten HTTP-Trigger ein. Hosts nur mit FTP und der Trigger.
Datenbanken
Funktionieren Migrationen auf jeder Datenbank? Ja, mit Unterschieden: PostgreSQL und SQLite nehmen eine gescheiterte Migration vollständig zurück, MySQL/MariaDB und Oracle ihre Daten, aber nicht ihre Schemaänderungen, MongoDB hat keine Transaktionen; der Sicherungspunkt deckt den Rest ab (Oracle von Hand). Hinweise zu den Datenbanken.
Wie füge ich auf jeder Engine eine Spalte hinzu? Über den Schema-Handler der Engine, wie es die eigenen Upgrade-Schritte des Kernels tun. Eine Spalte oder einen Index hinzufügen.
Umstieg von anderen Werkzeugen
Ich kenne Doctrine Migrations. Was ist anders? Migrationen ändern Inhalte ebenso wie das Schema, und jeder Lauf hat Sicherungspunkte, eine Aufzeichnung in Git und eine Seite in der Administration. Umstieg von Doctrine Migrations, Exponential-Migrationen für Doctrine-Nutzer.
Wir haben auf eZ Platform das Kaliop-Migrations-Bundle genutzt. Können wir unser YAML umwandeln?
Ja: ./console exp:migration:convert <Datei oder Ordner> liest die YAML-Migrationen dieses Bundles und schreibt für
jede Datei eine YAML-Migration von Exponential; prüfen Sie jede, bevor sie läuft.
Umstieg vom Kaliop-Migrations-Bundle,
Migrationen des Referenz-Bundles umwandeln.
Verwandte Seiten
- Migrationen: der Einstieg, Alle Rezepte
- Die Anleitung, das Tutorial, PHP-Migrationen, Zurücknehmen und Sicherungspunkte, Das Migrations-Repository
- In der Administration, Befehle, Einstellungen, Richtlinien, Ansichten und Ereignisse
- Das Dateiformat, Die Funktion
- Wenn eine Migration scheitert, Fehlermeldungen
- Migrationen oder Umzug einer Site
- Glossar
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.