Migrationseinstellungen
Die Einstellungen der Migrationen stehen in settings/migration.ini. Ändern Sie diese Datei nie selbst: Ein Update
ersetzt sie. Was Sie ändern, gehört in eine Überschreibung:
settings/override/migration.ini.append.phpfür die Installation,settings/siteaccess/<siteaccess>/migration.ini.append.phpfür einen Siteaccess,extension/<erweiterung>/settings/migration.ini.append.phpin einer Erweiterung (gelesen, solange sie aktiv ist).
# settings/override/migration.ini.append.php auf einer Entwicklungsinstallation
[RepositorySettings]
Push=disabled
*/ ?>Inhalt
migration.ini
| Block und Einstellung | Voreinstellung | Was sie bewirkt |
|---|---|---|
| [MigrationSettings] (Referenz) | wo Migrationen gefunden werden | |
Enabled | enabled | disabled findet gar keine Migrationen |
DirectoryList[] | migrations | die Migrationsordner der Site; in den ersten schreibt exp:migration:generate |
ExtensionDirectory | migrations | der Ordner in jeder aktiven Erweiterung und jedem installierten Paket |
| [RunSettings] (Referenz) | wie sich ein Lauf verhält | |
RunAsUser | admin | der Login, unter dem ein Konsolenlauf läuft (ein Lauf in der Administration läuft unter dem angemeldeten Benutzer) |
StopOnFailure | enabled | beim ersten Fehler anhalten; disabled macht mit den Migrationen weiter, die die gescheiterte nicht brauchen |
Throttle | leer | leer ausgeliefert; der Runner von 6.0.15 liest sie nicht (pausieren Sie in einer langen Migration selbst, siehe Große Datenmigrationen) |
| [CaptionSettings] (Referenz) | die Sicherungspunkte um einen Lauf | |
Before | enabled | ein Sicherungspunkt (Art migration-pre) vor jedem Lauf |
After | enabled | ein Sicherungspunkt (Art migration-post) nach einem erfolgreichen Lauf |
ReuseUnchanged | enabled | den neuesten Sicherungspunkt wiederverwenden, solange sich seitdem nichts geändert hat |
ReuseIgnoreTableList[] | exp_migration, exp_migration_run, expupgrade_step, ezsession, expaudit_* | Tabellen, die die Prüfung für die Wiederverwendung auslässt |
RestoreOnFailure | enabled | den Sicherungspunkt von vorher nach einem Fehler wiederherstellen |
RestoreParts[] | database, storage, settings | die Teile eines Sicherungspunkts, die die Wiederherstellung zurücksetzt |
CodeTreeList[] | settings, extension, design | Verzeichnisbäume, die vor --apply auf nicht committete Änderungen geprüft werden |
BackupDirectory | leer (var/backup/upgrade) | wo Sicherungspunkte ohne git_manager liegen |
| [RepositorySettings] (Referenz) | die Aufzeichnung in Git | |
Mode | site | site: der eigene Checkout der Installation; separate: ein eigenes Repository unter Path |
Path | migrations | der Ordner der Statusdateien und Laufprotokolle |
Remote | origin | das Remote, auf das gepusht wird; leer: kein Push |
Branch | leer | der Branch, auf dem committet wird; leer: der aktuelle |
Commit, Tag, Push | enabled | die Aufzeichnung committen, den Commit taggen, beides pushen |
TagPattern | migrations/<environment>/<run-id> | der Name des Tags; Platzhalter <environment>, <run-id>, <date> |
| [AdminSettings] (Referenz) | in Setup > Migrationen gestartete Läufe | |
PhpCliPath | leer | das PHP-Kommandozeilenprogramm, das sie im Hintergrund ausführt |
JobHistory | 50 | wie viele Läufe ihre Dateien in var/<site>/migration/jobs/ behalten |
LogBytes | 262144 | wie viel vom Ende eines Laufprotokolls eine Seite zeigt |
Jede Einstellung mit ihrem vollständigen Kommentar: die Blöcke von migration.ini.
Eine Erweiterung kann ExtensionDirectory woanders hin zeigen lassen:
die Erweiterungspunkte von migration.ini.
Einstellungen in anderen Dateien
| Datei und Block | Einstellung | Für Migrationen |
|---|---|---|
site.ini [AdminEnvironment] (Referenz) | Level | die Umgebung der Installation (development, test, staging, production; auto liest EXP_ENV), die die Kopfzeile environments: und der Name der Statusdatei nutzen |
site.ini [ReauthGroup_system] (Referenz) | „Identität bestätigen“ vor einem Lauf, einer Fortsetzung, einer Simulation und einer Rücknahme in der Administration | |
dashboard.ini [DashboardBlock_migrations] (Referenz) | PolicyList[] | der Dashboard-Block, für Benutzer mit migration/read |
audit.ini [AuditEventSettings] (Referenz) | Enabled[] | die Audit-Ereignisse system.migration.run, .apply, .fail, .rollback, .caption, .push |
cronjob.ini [CronjobPart-migrationpush] (Referenz) | Scripts[] | der Teil, der Läufe mit gescheitertem Push erneut pusht (der Cronjob-Teil) |
upgrade.ini [UpgradeSettings] (Referenz) | ExtensionStepList[] | die Upgrade-Schritte einer Erweiterung, die unter den Migrationen als Quelle kernel gelistet werden |
Typische Einstellungen je Umgebung
| Entwicklung | Staging | Produktion | |
|---|---|---|---|
[AdminEnvironment] Level | development | staging | production |
[RepositorySettings] Push | disabled (oder --no-push) | enabled | enabled |
[CaptionSettings] Before, After | enabled (günstig auf SQLite) | enabled | enabled |
[CaptionSettings] RestoreOnFailure | enabled | enabled | enabled |
[RunSettings] RunAsUser | admin | ein eigener Administrator-Login | ein eigener Administrator-Login |
Eine Einstellung, die sich je Umgebung unterscheidet, gehört in die eigene Überschreibung der Umgebung (zum Beispiel die
Variantendateien von EXP_ENV, settings/override/site.ini.prod.append.php), nie in eine Migration: Migrationen sind
auf jeder Installation dieselben Dateien (Migrationen je Umgebung).
Verwandte Seiten
- Migrationen: der Einstieg, Alle Rezepte, Häufige Fragen
- Die Anleitung, das Tutorial, PHP-Migrationen, Zurücknehmen und Sicherungspunkte, Das Migrations-Repository
- In der Administration, Befehle, Richtlinien, Ansichten und Ereignisse
- Das Dateiformat, Die Funktion
- Wenn eine Migration scheitert, Fehlermeldungen
- Migrationen oder Umzug einer Site
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.