Eine Deployment-Pipeline
Diese Seite ist für Anwendungsentwickler, die festlegen, wie Änderungen in die Produktivumgebung gelangen. Das Ziel: derselbe Code und dieselben Schritte in jeder Umgebung, Einstellungen, die sich je Rechner unterscheiden, getrennt gehalten, und ein Weg zurück, wenn etwas schiefgeht.
Inhalt
Umgebungen
| Umgebung | Zweck | Einstellungen |
|---|---|---|
| Entwicklung | der Rechner jedes Entwicklers | EXP_ENV=dev: Debug an, Mailversand in Dateien |
| Test / Staging | eine Kopie der Produktivumgebung für die Abnahme | EXP_ENV=test |
| Produktivumgebung | die Live-Website | die Basiseinstellungen |
EXP_ENV benennt die Umgebung, und jede Einstellungsdatei kann eine Variante dafür haben (site.ini.test.append.php)
(Umgebungseinstellungen und Geheimnisse, Einstellungen pro Umgebung).
Was wie übertragen wird
| Gegenstand | Übertragen per |
|---|---|
| Kernel und Erweiterungen | Git und Composer (composer.lock im Projekt committet) |
| Ihre Erweiterung | ihr Git-Tag, per Version eingebunden |
| Einstellungen | Git, ohne Geheimnisse; Geheimnisse pro Rechner gesetzt |
| Inhaltsklassen | Pakete oder Upgrade-Skripte, nie durch doppeltes Klicken (Inhaltspakete) |
| Tabellen | Ihre Installations- und Upgrade-Befehle (Datenbankschema und .dba-Dateien) |
| Inhalte | bleiben in der Produktivumgebung; kopieren Sie die Produktivumgebung nach Staging, nie umgekehrt |
Ein Release, Schritt für Schritt
- Die Tests laufen in der CI durch (Continuous Integration für Erweiterungen).
- Auf Staging ausliefern, die Upgrade-Schritte ausführen, testen.
- Produktivumgebung: ein Backup anlegen (Backups und Wiederherstellungen).
- Wartungsmodus, wenn das Release Daten ändert (
php bin/php/maintenance.php on --allow-admin). - Den Code aktualisieren (Git pull oder
composer update <package>des Projekts), die Upgrade-Schritte ausführen. ./console exp:velocity deploy(--kernel, wenn sich Kernel-Klassen geändert haben) (Mit Velocity ausliefern).- Wartungsmodus aus; prüfen.
Rollback
- Code: das vorherige Tag auschecken und erneut ausliefern.
- Daten: das vor dem Release angelegte Backup wiederherstellen, wenn Upgrade-Schritte Daten geändert haben; deshalb kommt Schritt 3 zuerst.
- Schreiben Sie Upgrade-Schritte nach Möglichkeit so, dass sie nur hinzufügen (Spalten, Klassen), damit der vorherige Code auch mit den neuen Daten noch läuft.
Prüfung
- To do:
exp:velocity status: Der Server antwortet;exp:cache statusendet mit PASS. - To do: Die Startseite, eine Seite jedes geänderten Typs, die Administration.
- To do: Das Fehlerlog bleibt ruhig.
- To do: Setup > Upgrade-Prüfung für die Dateikonsistenz (Upgrade-Prüfung).
- To do: Die Seite "Über" zeigt die erwarteten Versionen.
Verwandte Seiten
- Mit Velocity ausliefern
- Ein Team mit Git führen
- Kompatibilität, Releases und Deployment
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.