Enlaces de ciclo de vida para las implementaciones de servicios de Amazon ECS

Cuando se inicia una implementación, pasa por las etapas del ciclo de vida. Estas etapas pueden estar en estados como IN_PROGRESS o SUCCESSFUL. Puede utilizar enlaces de ciclo de vida, que son funciones de Lambda que Amazon ECS ejecuta en su nombre en etapas del ciclo de vida específicas. Las funciones pueden ser cualquiera de las siguientes opciones:

Una API asíncrona que valida la comprobación de estado en 15 minutos.
Una API de sondeo que inicia otro proceso asíncrono que evalúa la finalización del enlace de ciclo de vida.

Una vez que la función haya terminado de ejecutarse, debe devolver un hookStatus para que la implementación continúe. Si no se devuelve un hookStatus o si la función falla, la implementación se revierte. Los siguientes son valores del hookStatus:

SUCCEEDED: la implementación pasa a la siguiente fase del ciclo de vida.
FAILED: la implementación se revierte a la última implementación correcta.
IN_PROGRESS: Amazon ECS vuelve a ejecutar la función tras un breve periodo. De forma predeterminada, es un intervalo de 30 segundos; sin embargo, este valor se puede personalizar devolviendo un callBackDelaySeconds junto con el hookStatus.

En el siguiente ejemplo se muestra cómo devolver un hookStatus con un retraso de devolución de llamada personalizado. En este ejemplo, Amazon ECS volvería a intentar este enlace en 60 segundos en lugar de los 30 segundos predeterminados:



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

Cuando se produce una reversión, Amazon ECS ejecuta los enlaces de ciclo de vida para las siguientes etapas de dicho ciclo de vida:

PRODUCTION_TRAFFIC_SHIFT
TEST_TRAFFIC_SHIFT

Cargas útiles del ciclo de vida

Cuando configura los enlaces de ciclo de vida para las implementaciones de sus servicios de ECS, Amazon ECS invoca estos enlaces en etapas específicas del proceso de implementación. Cada etapa del ciclo de vida proporciona una carga útil de JSON con información acerca del estado actual de la implementación. En este documento se describe la estructura de carga útil de cada etapa del ciclo de vida.

Estructura común de las cargas útiles

Todas las cargas útiles de las etapas del ciclo de vida incluyen los siguientes campos comunes:

serviceArn: el nombre de recurso de Amazon (ARN) del servicio.
targetServiceRevisionArn: el ARN de la revisión de servicio de destino que se está implementando.
testTrafficWeights: un mapa de los ARN de las revisiones de servicio con sus correspondientes porcentajes de ponderación de tráfico de prueba.
productionTrafficWeights: un mapa de los ARN de las revisiones de servicio con sus correspondientes porcentajes de ponderación de tráfico de producción.

Cargas útiles de las etapas del ciclo de vida

RECONCILE_SERVICE

Esta etapa se produce al principio del proceso de implementación cuando se está conciliando el servicio. A continuación, se muestra un ejemplo de carga útil para esta etapa del ciclo de vida.



{
  "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
  }
}