Migrationen #

Eine Migration ist eine Änderung an einer Installation (eine Tabelle, eine Spalte, eine Inhaltsklasse, Inhalte, eine Rolle, eine Einstellung), einmal in einer PHP-Datei unter Versionskontrolle geschrieben und auf jede Installation der Site (Entwicklung, Staging, Produktion) in derselben Reihenfolge angewendet. Exponential 6.0.15 führt Migrationen im Kernel aus: Es hält fest, was wo gelaufen ist, nimmt vor jedem Lauf einen Sicherungspunkt, stellt ihn automatisch wieder her, wenn eine Migration scheitert, und committet, taggt und pusht die Aufzeichnung jedes Laufs.

Suchen Sie etwas anderes? Eine Site auf einen anderen Server umziehen, sie auf ein neues Release bringen oder Inhalte aus einem anderen System übernehmen heißt eine Site migrieren – eine andere Aufgabe mit eigenen Seiten: Migrationen oder Umzug einer Site.

Inhalt #

1. Hier beginnen
2. Für wen
3. Rezepte
4. In der Administration
5. Referenz
6. Wenn etwas schiefgeht
7. YAML-Migrationen
8. Was 6.0.15 bietet und was später kommt
9. Verwandte Seiten

Hier beginnen #

Die fünf Befehle für jeden Tag:

./console exp:migration:generate --skeleton add_news_table --apply   # eine neue PHP-Migration in migrations/
./console exp:migration:check                                         # die Prüfung: Namen, Kopf, Reihenfolge, PHP (ohne Datenbank)
./console exp:migration:migrate                                       # Probelauf: was sich ändern würde
./console exp:migration:migrate --apply                               # Sicherungspunkt, Lauf, neuer Sicherungspunkt, Commit, Tag, Push
./console exp:migration:status                                        # was erledigt ist und was aussteht

Führen Sie sie im Wurzelverzeichnis der Installation als der Benutzer aus, unter dem der Webserver läuft (als root mit --allow-root-user). Jeder Befehl, der schreibt, ist ein Probelauf, bis er --apply bekommt.

Für wen #

Rezepte #

Jedes Rezept ist eine Aufgabe: was Sie am Ende haben, die Schritte mit ihrer Ausgabe, die vollständige Migration, wie Sie sie prüfen, wie Sie sie zurücknehmen und der nächste Schritt. Alle Rezepte.

Das Datenbankschema

• Eine Datenbanktabelle anlegen
• Eine Spalte oder einen Index hinzufügen
• Hinweise zu den Datenbanken: MySQL, PostgreSQL, SQLite, Oracle und MongoDB

Inhaltsklassen und Inhalte

• Eine Inhaltsklasse anlegen oder ändern
• Ein Klassenattribut hinzufügen
• Inhalte in großen Mengen ändern
• Daten korrigieren
• Inhalte für eine neue Site anlegen
• Große Datenmigrationen

Einstellungen, Rollen und Richtlinien

• INI-Einstellungen verschieben oder umbenennen
• Rollen und Richtlinien hinzufügen

Wo Migrationen liegen und laufen

• Migrationen je Umgebung
• Migrationen in einer Erweiterung oder einem Paket
• Upgrade-Schritt oder Migration?

Qualität

• Ein umkehrbares down() schreiben
• Migrationen testen
• Eine Migration im Code-Review prüfen

Teams und Auslieferung

• Teamarbeit mit Git
• Mit Migrationen ausliefern
• Tags pushen

Sicherheit und die Aufzeichnung

• Sicherungspunkte und Rücknahme in der Praxis
• Die Audit-Spur der Läufe

Umstieg von einem anderen Werkzeug

• Umstieg von Doctrine Migrations
• Umstieg vom Kaliop-Migrations-Bundle
• Umstieg von SQL-Update-Dateien

In der Administration #

Setup > Migrationen zeigt jede Migration mit ihrem Zustand, führt die ausstehenden im Hintergrund aus, simuliert einen Lauf und nimmt einen Lauf oder eine Migration zurück, zeichnet Änderungen auf, schreibt Migrationen in seinem Editor und liefert sie an andere Installationen aus. Das Dashboard hat einen Block Migrationen, die Website-Seitenleiste ein Panel. Jede Seite unten hat Anleitungen Schritt für Schritt mit Bildschirmfotos.

• Ein Rundgang durch Setup > Migrationen: jeder Reiter mit Bildschirmfoto, und welche Seite für welche Aufgabe
• Migrationen in der Administration: die Seiten und wer sie nutzen darf
• Stand und Verlauf
• Ausführen, Probelauf und Rücknahme
• Migrationen in der Website-Seitenleiste
• Änderungen aufzeichnen: die eigenen Änderungen oder in einem websiteweiten Fenster jede Änderung als Schritte einer Migration aufzeichnen
• Gegenstellen und Deploys: die anderen Installationen, an die diese ihre Migrationen ausliefert, Deploys gleichzeitig oder Stufe für Stufe mit einem Tor, live je Gegenstelle, Verlauf und Rücknahme
• Eine Gegenstelle anlegen, Schritt für Schritt: die fünf Schritte des Assistenten, Verbindung testen, bearbeiten und entfernen, FTP-Hosts mit dem Trigger, Selbstheilung
• Ausliefern, Schritt für Schritt: Gegenstellen wählen, Preflight, ausliefern, live verfolgen, ein Tor freigeben, zurücknehmen, der Verlauf und die Hinweis-Mails
• Der Migrationseditor: eine YAML-Migration mit Formularen bauen, prüfen, ansehen und speichern
• Migrationen erzeugen: aus einer Aufzeichnung, im Editor, aus dem Vorhandenen, aus einem Unterschied, Gerüste

Referenz #

Wenn etwas schiefgeht #

• Wenn eine Migration scheitert: Fehlerbehebung nach Symptom
• Fehlermeldungen: jede Meldung, die die Befehle ausgeben
• Häufige Fragen
• Zurücknehmen und Sicherungspunkte

YAML-Migrationen #

Eine Migration kann statt einer PHP-Klasse eine Liste von YAML-Schritten sein: Inhalte, Orte und Versionen, Klassen und Klassengruppen, Benutzer, Benutzergruppen und Rollen, Sektionen, Sprachen und Objektzustände. Die Engine, ihre Platzhalter, Bedingungen und Schleifen: das Dateiformat; die Schritttypen: Schritte von YAML-Migrationen und jeder Schritttyp. Die Rezepte hier sind in PHP geschrieben; jedes lässt sich auch als YAML-Schritte schreiben, wo ein Schritttyp es abdeckt.

Was 6.0.15 bietet und was später kommt #

Verwandte Seiten #

• Migrationen: die Anleitung, das Tutorial, PHP-Migrationen
• Alle Rezepte, Häufige Fragen
• Migrationen oder Umzug einer Site
• Migration zu und von Exponential (eine Site aus einem anderen System oder Release umziehen)
• Upgrade mit der Konsole, Upgrade-Schritte für Erweiterungen
• Schemaänderungen und Migrationen
• Ein Rundgang durch die Administration
• Glossar
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.