Lifecycle-Hooks für Amazon ECS-Servicebereitstellungen

Wenn eine Bereitstellung beginnt, durchläuft sie Lebenszyklusphasen. Diese Phasen können sich in einem Status wie IN_PROGRESS oder erfolgreich befinden. Sie können Lifecycle-Hooks verwenden, bei denen es sich um Lambda-Funktionen handelt, die Amazon ECS in Ihrem Namen in bestimmten Lebenszyklusphasen ausführt. Bei den Funktionen kann es sich um eine der folgenden Funktionen handeln:

Eine asynchrone API, die die Integritätsprüfung innerhalb von 15 Minuten validiert.
Eine Abfrage-API, die einen weiteren asynchronen Prozess initiiert, der den Abschluss des Lifecycle-Hooks bewertet.

Nachdem die Funktion die Ausführung abgeschlossen hat, muss sie a zurückgeben, damit die Bereitstellung hookStatus fortgesetzt werden kann. Wenn a nicht zurückgegeben hookStatus wird oder wenn die Funktion fehlschlägt, wird die Bereitstellung zurückgesetzt. Im Folgenden sind die hookStatus Werte aufgeführt:

SUCCEEDED- Die Bereitstellung wird bis zur nächsten Lebenszyklusphase fortgesetzt
FAILED— Die Bereitstellung wird auf die letzte erfolgreiche Bereitstellung zurückgesetzt.
IN_PROGRESS— Amazon ECS führt die Funktion nach kurzer Zeit erneut aus. Standardmäßig ist dies ein 30-Sekunden-Intervall. Dieser Wert kann jedoch angepasst werden, indem callBackDelaySeconds neben dem ein zurückgegeben wirdhookStatus.

Das folgende Beispiel zeigt, wie a hookStatus mit einer benutzerdefinierten Rückrufverzögerung zurückgegeben wird. In diesem Beispiel würde Amazon ECS diesen Hook in 60 Sekunden statt in den standardmäßigen 30 Sekunden wiederholen:



{
    "hookStatus": "IN_PROGRESS",
    "callBackDelaySeconds": 60
}

Wenn ein Rollback stattfindet, führt Amazon ECS die Lifecycle-Hooks für die folgenden Lebenszyklusphasen aus:

PRODUCTION_TRAFFIC_SHIFT
TRAFFIC SHIFT TESTEN

Nutzlasten im Lebenszyklus

Wenn Sie Lifecycle-Hooks für Ihre ECS-Servicebereitstellungen konfigurieren, ruft Amazon ECS diese Hooks in bestimmten Phasen des Bereitstellungsprozesses auf. Jede Lebenszyklusphase stellt eine JSON-Payload mit Informationen über den aktuellen Status der Bereitstellung bereit. In diesem Dokument wird die Payload-Struktur für jede Lebenszyklusphase beschrieben.

Gemeinsame Payload-Struktur

Alle Payloads in der Lebenszyklusphase enthalten die folgenden gemeinsamen Felder:

serviceArn- Der Amazon-Ressourcenname (ARN) des Dienstes.
targetServiceRevisionArn— Der ARN der Zieldienstrevision, die bereitgestellt wird.
testTrafficWeights- Eine Zuordnung der Service-Revisionen ARNs zu den entsprechenden Prozentwerten des Testverkehrs in Prozent.
productionTrafficWeights- Eine Übersicht über die Änderung der Dienste im Vergleich ARNs zu den entsprechenden prozentualen Gewichtsanteilen für den Produktionsverkehr.

Nutzlasten in der Lebenszyklusphase

RECONCILE_SERVICE

Diese Phase findet zu Beginn des Bereitstellungsprozesses statt, wenn der Dienst abgeglichen wird. Im Folgenden wird ein Beispiel für eine Payload für diese Lebenszyklusphase gezeigt.



{
  "serviceArn": "arn:aws:ecs:us-west-2:1234567890:service/myCluster/myService",
  "targetServiceRevisionArn": "arn:aws:ecs:us-west-2:1234567890:service-revision/myCluster/myService/01275892",
  "testTrafficWeights": {
    "arn:aws:ecs:us-west-2:1234567890:service-revision/myCluster/myService/01275892": 100,
    "arn:aws:ecs:us-west-2:1234567890:service-revision/myCluster/myService/78652123": 0
  },
  "productionTrafficWeights": {
    "arn:aws:ecs:us-west-2:1234567890:service-revision/myCluster/myService/01275892": 100,
    "arn:aws:ecs:us-west-2:1234567890:service-revision/myCluster/myService/78652123": 0
  }
}