Code-Bereitstellung code-deployment

Erfahren Sie, wie Sie Code bereitstellen und was dabei in Cloud Manager passiert.

Bereitstellen von Code mit Cloud Manager deploying-code-with-cloud-manager

Sobald die Produktions-Pipeline einschließlich des erforderlichen Repositorys und der erforderlichen Umgebungen konfiguriert ist, kann der Code bereitgestellt werden.

Der Build-Prozess startet den Code-Bereitstellungsprozess einschließlich der folgenden Schritte:

Sie können die Schritte verschiedener Bereitstellungsprozesse überprüfen, indem Sie die Protokolle lesen oder die Ergebnisse anhand der Testkriterien durchgehen.

Bereitstellungsschritte deployment-steps

In jedem Schritt der Bereitstellung werden verschiedene Aktionen ausgeführt, die in diesem Abschnitt beschrieben werden. Unter Details zum Bereitstellungsprozess finden Sie technische Einzelheiten dazu, wie der Code selbst im Hintergrund bereitgestellt wird.

Schritt zur Staging-Bereitstellung stage-deployment

Der Schritt Staging-Bereitstellung umfasst die folgenden Aktionen:

Schritt zu Staging-Tests stage-testing

Der Schritt Staging-Tests umfasst die folgenden Aktionen:

Schritt zur Produktionsbereitstellung production-deployment

Der Schritt Produktionsbereitstellung umfasst die folgenden Aktionen:

Sobald die Bereitstellung abgeschlossen ist, befindet sich der Code in der Zielumgebung und Sie können die Protokolle anzeigen.

Zeitüberschreitungen timeouts

Die folgenden Schritte führen zu einem Timeout, wenn auf Benutzer-Feedback gewartet wird:

Details zum Bereitstellungsprozess deployment-process

Cloud Manager lädt alle beim Build-Prozess generierten target/*.zip-Dateien in einen Speicherort hoch. Diese Artefakte werden in der Pipeline-Bereitstellungsphase von diesem Speicherort abgerufen.

Wenn Cloud Manager in produktionsfremden Topologien bereitgestellt wird, besteht das Ziel darin, die Bereitstellung so schnell wie möglich abzuschließen. Daher werden die Artefakte wie folgt auf allen Knoten gleichzeitig bereitgestellt:

Bereitstellung in der Produktionsphase deployment-production-phase

Der Bereitstellungsvorgang für Produktionstopologien unterscheidet sich geringfügig, um die Auswirkungen auf die Besuchenden von AEM-Websites zu minimieren.

Produktionsbereitstellungen nutzen im Allgemeinen die oben beschriebenen Schritte, aber auf rollierende Weise:

Dieser Vorgang wird fortgesetzt, bis die Bereitstellung alle Publisher und Dispatcher in der Topologie erreicht hat.

Notfall-Pipeline-Ausführungsmodus emergency-pipeline

In kritischen Situationen müssen Adobe Managed Services-Kundinnen und -Kunden möglicherweise Code-Änderungen sofort in ihren Staging- und Produktionsumgebungen bereitstellen. Durch diesen Modus können sie den gesamten Cloud Manager-Testzyklus umgehen.

Um diese Situationen zu beheben, kann die Cloud Manager-Produktions-Pipeline in einem Notfall-Modus ausgeführt werden. Wenn dieser Modus verwendet wird, werden die Sicherheits- und Leistungstestschritte nicht ausgeführt. Alle anderen Schritte, einschließlich aller konfigurierten Genehmigungsschritte, werden wie im normalen Pipeline-Ausführungsmodus ausgeführt.

Verwenden des Notfall-Pipeline-Ausführungsmodus using-emergency-pipeline

Beim Starten der Ausführung einer Produktions-Pipeline können Sie in einem Dialogfeld zwischen Normalmodus und Notfallmodus wählen. Diese Option ist verfügbar, wenn die Funktion für den Notfall-Pipeline-Ausführungsmodus für das Programm aktiviert ist. Eine Auswahl ist möglich, sobald die Funktion aktiviert wurde.

Wenn Sie die Seite mit den Pipeline-Ausführungsdetails für eine im Notfallmodus ausgeführte Ausführung anzeigen, wird in den Breadcrumbs am oberen Bildschirmrand ein Hinweis darauf angezeigt, dass die Pipeline im Notfallmodus ausgeführt wird.

Die Ausführung einer Pipeline im Notfallmodus kann auch über die Cloud Manager-API oder die CLI erfolgen. Um eine Ausführung im Notfallmodus zu starten, senden Sie mit dem Abfrageparameter ?pipelineExecutionMode=EMERGENCY eine PUT-Anfrage an den Ausführungsendpunkt der Pipeline. Alternativ haben Sie bei Verwendung der CLI folgende Möglichkeit:

$ aio cloudmanager:pipeline:create-execution PIPELINE_ID --emergency

Erneutes Ausführen einer Produktionsbereitstellung reexecute-deployment

In seltenen Fällen kann es vorkommen, dass Schritte der Produktionsbereitstellung aus vorübergehenden Gründen fehlschlagen. In diesen Fällen können Sie den Schritt zur Produktionsbereitstellung erneut ausführen, sofern er abgeschlossen wurde (unabhängig davon, ob erfolgreich, abgebrochen oder fehlgeschlagen). Die erneute Ausführung wird unterstützt, indem dieselbe Pipeline verwendet wird, die die drei folgenden Schritte umfasst:

In solchen Fällen, in denen eine erneute Ausführung möglich ist, bietet die Statusseite der Produktions-Pipeline neben der üblichen Option Build-Protokoll herunterladen auch die Option Erneut ausführen.

Einschränkungen limitations

Erneutes Ausführen der API reexecute-api

Zusätzlich zur Verfügbarkeit in der Benutzeroberfläche können Sie die Cloud Manager-API verwenden, um erneute Ausführungen auszulösen und Ausführungen zu identifizieren, die als erneute Ausführungen ausgelöst wurden.

Auslösen einer erneuten Ausführung triggering

Um eine erneute Ausführung auszulösen, muss eine PUT-Anfrage an die HAL-Verknüpfung http://ns.adobe.com/adobecloud/rel/pipeline/reExecute im Status des Schritts der Produktionsbereitstellung erfolgen.

Diese Verknüpfung ist immer nur für den Schritt der Produktionsbereitstellung verfügbar.

 {
  "_links": {
    "http://ns.adobe.com/adobecloud/rel/pipeline/logs": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/logs",
      "templated": false
    },
    "http://ns.adobe.com/adobecloud/rel/pipeline/reExecute": {
      "href": "/api/program/4/pipeline/1/execution?stepId=2983530",
      "templated": false
    },
    "http://ns.adobe.com/adobecloud/rel/pipeline/metrics": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/metrics",
      "templated": false
    },
    "self": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530",
      "templated": false
    }
  },
  "id": "6187842",
  "stepId": "2983530",
  "phaseId": "1575676",
  "action": "deploy",
  "environment": "weretail-global-b75-prod",
  "environmentType": "prod",
  "environmentId": "59254",
  "startedAt": "2022-01-20T14:47:41.247+0000",
  "finishedAt": "2022-01-20T15:06:19.885+0000",
  "updatedAt": "2022-01-20T15:06:20.803+0000",
  "details": {
  },
  "status": "FINISHED"

Die Syntax für den Wert href der HAL-Verknüpfung ist nur ein Beispiel, und der tatsächliche Wert sollte immer aus der HAL-Verknüpfung ausgelesen und nicht generiert werden.

Das Senden einer PUT-Anfrage an diesen Endpunkt führt bei Erfolg zu einer 201-Antwort. Der Antworttext entspricht der Darstellung der neuen Ausführung. Diese Funktionalität ähnelt dem Starten einer regulären Ausführung über die API.

Identifizieren einer Ausführung mit erneuter Ausführung identifying

Das System identifiziert erneut ausgeführte Ausführungen anhand des Werts RE_EXECUTE im Feld „Trigger“.