[Beta]{class="badge positive"}
Verwenden Sie kanarische Bereitstellungen, um Code zu validieren canary-deployments
Bei AEM Cloud Service-Implementierungen können Sie bei Canary-Bereitstellungen in Cloud Manager neuen Code auf der Veröffentlichungsebene der Live-Produktionsinfrastruktur validieren, bevor Sie echten Benutzer-Traffic an diese weiterleiten. Sie stellen die neue Version zusammen mit der aktuellen stabilen Version bereit und erreichen sie über einen dedizierten Anfrage-Header. Nachdem Sie bestätigt haben, dass die neue Version erfolgreich funktioniert, können Sie sie entweder auf den gesamten Traffic weiterleiten (dies geschieht automatisch nach einem 3-Stunden-Fenster) oder zurücksetzen.
Entwicklungs- und Staging-Umgebungen bleiben die primären Orte zum Testen von Code-Versionen. Kanarische Bereitstellungen bieten eine zusätzliche Möglichkeit zu überprüfen, ob eine Version erwartungsgemäß funktioniert. Beispielsweise ist es nützlich, wenn die AEM-Produktion mit dem Produktionsendpunkt eines externen Services integriert wird, der in niedrigeren AEM-Umgebungen nicht explizit validiert wird.
Canary-Bereitstellungen dienen der internen Validierung, nicht zur Verschiebung des echten Benutzer-Traffics von der alten zur neuen Version. Der echte Benutzer-Traffic wird nie automatisch zu den Canary-Instanzen geleitet.
Canary-Bereitstellungsprozess how-canary-deployments-work
Wenn Sie eine Full-Stack-Pipeline ausführen, bei der Canary-Bereitstellungen aktiviert sind, startet Cloud Manager einen separaten Satz von Canary-Instanzen für den neuen Build, während Ihre stabilen Instanzen weiterhin für Ihre Benutzerinnen und Benutzer dienen. Der Prozess folgt diesen Schritten:
- Sie führen eine Full-Stack-Bereitstellungs-Pipeline (Staging- oder Produktionsumgebung) aus, für die Canary-Bereitstellungen aktiviert sind.
Siehe Ausführen einer Pipeline und Aktivieren von Kanarienbereitstellungen. - Während des Bereitstellungsschritts startet Cloud Manager kanarische Instanzen, auf denen die neue Code-Version ausgeführt wird.
- Ihre vorhandenen stabilen Instanzen dienen weiterhin Live-Traffic.
- Sie erreichen die neue Version selektiv, indem Sie einen kanarischen Anfrage-Header hinzufügen. Siehe Zugriff auf die Version von Canary.
- Während eines Validierungsfensters stufen Sie die Canary-Version auf den gesamten Traffic hoch oder brechen sie ab. Siehe Validieren und Hochstufen oder Abbrechen.
Canary-Bereitstellungen aktivieren enable-canary-deployments
Sie aktivieren Canary-Bereitstellungen in der Full-Stack-Pipeline. Canary-Bereitstellungen werden nur für Staging- und - unterstützt. Beachten Sie, dass eine Pipeline, die für die Bereitstellung in der Staging- und Produktionsumgebung konfiguriert ist, die Canary-Bereitstellung nur in der Produktion ausführt, wie unten dargestellt.
Kanarisches Bereitstellungsverhalten nach Pipeline-Typ
Wo die Canary-Bereitstellung ausgeführt wird, hängt vom Pipeline-Typ ab.
So aktivieren Sie Canary-Bereitstellungen:
-
Fügen Sie in Cloud Manager eine neue Pipeline ) oder bearbeiten Sie eine vorhandene Pipeline die Full-Stack-Code in einer Staging- oder Produktionsumgebung bereitstellt.
-
Klicken Dialogfeld „Produktions-Pipeline bearbeiten auf die Registerkarte Source-Code.
-
Klicken Sie Abschnitt Pipeline“ unter der Überschrift Produktionsbereitstellungsoptionen auf Canary-Bereitstellung (Beta).
-
Klicken Sie Aktualisieren, um die Aktivierung der Pipeline abzuschließen.
Während des Validierungsfensters erreichen nur Anfragen, die den Canary-Header enthalten, die neu bereitgestellte Version. Alle anderen Anfragen erreichen weiterhin die stabile Version.
Zugriff auf die Canary-Version access-the-canary-release
Nachdem Cloud Manager die Canary-Instanzen gestartet hat, erreichen Sie die neue Version, indem Sie Ihren Anfragen einen HTTP-Header hinzufügen. Die stabile Version stellt weiterhin Anforderungen ohne -Header bereit.
Um eine Anfrage an die Canary-Version zu senden, fügen Sie die folgende Kopfzeile hinzu:
X-Aem-Canary: true
Validieren und Hochstufen oder Abbrechen validate-and-promote-or-cancel
Wenn die Kanarischen Instanzen fertig sind, wird ein Validierungsfenster geöffnet, in dem Sie die neue Version testen können. Cloud Manager zeigt die Optionen Zur Produktion weiterleiten und Bereitstellung abbrechen im Abschnitt Für Produktion bereitstellen.
Promotion der Kanarischen Version promote-the-canary-release
Um den gesamten Live-Traffic zur neuen Version zu leiten, klicken Sie auf “zur Produktion”. Wenn Sie die Version Canary bewerben:
- Die Canary-Version wird die neue stabile Version.
- Cloud Manager leitet den gesamten Live-Traffic an die neue Version weiter.
- Rollback ist nicht mehr verfügbar.
Abbrechen der Kanarienbereitstellung cancel-the-canary-deployment
Wenn während des Validierungsfensters Probleme auftreten, klicken Sie auf Bereitstellung abbrechen. Wenn Sie die Bereitstellung der Kanarischen Inseln abbrechen:
- Cloud Manager stoppt die Canary-Version und entfernt die Canary-Instanzen.
- Die vorherige stabile Version dient weiterhin dem Traffic.
- Abbruch ist nur während des Validierungsfensters verfügbar.
Umfang und Einschränkungen scope-and-limitations
Beachten Sie bei der Verwendung von Canary-Bereitstellungen den folgenden Umfang und die folgenden Einschränkungen:
- Kanarische Bereitstellungen gelten nur für die Veröffentlichungsebene. Die Autorenebene bleibt während der Kanarienvalidierung auf der stabilen Version.
- Ihre Änderungen müssen abwärtskompatibel sein, damit die Canary-Veröffentlichungsinstanzen Ihre vorhandenen Inhaltsstrukturen bereitstellen können.
- Veränderliche Inhaltsänderungen in einer Version werden angewendet, nachdem Sie die Canary-Version weitergeleitet haben. Diese Änderungen sind während der Validierung auf den Kanarischen Instanzen nicht verfügbar.