Checkliste für den Livegang einer Integration #

Diese Seite ist für das Team, das eine Integration in Produktion bringt. Arbeiten Sie sie der Reihe nach durch; jeder Abschnitt endet mit einem Entscheidungspunkt. Die Schritte für die Website als Ganzes stehen unter Livegang einer neuen Kundenwebsite.

Inhalt #

1. Eine Woche vorher
2. Am Vortag
3. Livegang
4. Erste Läufe
5. Rückabwicklung
6. Hypercare

Eine Woche vorher #

• To do: Abnahmefälle in Staging bestanden; Freigabe festgehalten.
• To do: Sicherheitsprüfung bestanden (Checkliste).
• To do: Zugangsdaten für die Produktion angelegt und aufbewahrt; Dienstkonten und Rollen eingerichtet.
• To do: Die Integrationserweiterung veröffentlicht; die zu installierende Version ist ein Tag.
• To do: Überwachungsprüfungen gegen die Produktion konfiguriert, Alarme gehen an die richtigen Personen (Überwachung).
• To do: Runbook von einem Betreiber geprüft (Übergabe).
• To do: Die Verantwortlichen der anderen Systeme kennen den Termin und sind am Tag erreichbar.
• To do: Plan für die Rückabwicklung geschrieben (siehe unten) und ein Sicherungsverfahren getestet (Sicherungen: was zu sichern ist).

Entscheidung: los / verschieben.

Am Vortag #

• To do: Sicherung von Datenbank und var/storage angelegt und geprüft.
• To do: Deployment in Staging mit denselben Befehlen geprobt.
• To do: Ein Probelauf jedes Imports auf einer frischen Kopie der Produktion: Zahlen plausibel.
• To do: Cronjob-Zeilen vorbereitet, aber noch nicht aktiv.

Livegang #

1. Deployen Sie die Erweiterung und ihre Einstellungen:

   php bin/php/ezpgenerateautoloads.php -e
   php bin/php/console exp:velocity deploy --allow-root-user

2. Legen Sie die Tabellen der Erweiterung an (mit ihrem Installationsbefehl) und prüfen Sie sie.

3. Prüfen Sie die Schnittstellen von außen (ein REST-Aufruf mit dem Produktionsschlüssel, ein expservices-Aufruf, die Feed-Adresse).

4. Führen Sie die Erstbefüllung von Hand aus, als Benutzer der Website, und behalten Sie die Ausgabe:

   nice -n 15 php bin/php/console ext:myintegration:importproducts --file=var/import/articles.csv -s <siteaccess> \
       2>&1 | tee var/log/myintegration-initial-load.log

5. Leeren Sie, was die Befüllung nicht selbst leert (Caching nach Importen); bauen Sie den Suchindex neu auf, wenn die Indizierung verzögert war.

6. Verbinden Sie Workflows mit Triggern, schalten Sie Listener und Senken ein.

7. Aktivieren Sie die Cronjob-Zeilen; prüfen Sie sie unter Setup > Cronjobs.

Entscheidung: weiter / zurückabwickeln.

Erste Läufe #

• To do: Der erste geplante Lauf jedes Flusses hat stattgefunden, und seine Zusammenfassungszeile ist plausibel.
• To do: Der zweite Lauf jedes Imports meldet (fast) nur unchanged.
• To do: Die Teams der anderen Systeme bestätigen den Eingang der ersten ausgehenden Änderungen.
• To do: Keine neuen Fehler mit dem Namen der Integration in error.log; keine Ablehnungen im Audit.
• To do: Die Überwachung zeigt grün; ein Alarm wurde absichtlich ausgelöst und ist angekommen.

Rückabwicklung #

Schreiben Sie vor dem Livegang auf, wie Sie jeden Fluss stoppen und rückgängig machen:

Hypercare #

• To do: Tägliche Prüfung der Zusammenfassungszeilen jedes Flusses für den vereinbarten Zeitraum (zwei bis vier Wochen).
• To do: Schwellenwerte an die echten Volumen angepasst.
• To do: Fehler behoben und als neue Versionen veröffentlicht, nicht auf dem Server gepatcht.
• To do: Offene Punkte am Ende der Hypercare mit Verantwortlichen übergeben.

Verwandte Seiten #

• Playbook für Integrationsprojekte
• Integrationen testen
• Qualitätstore und Abnahme
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.