Enlaces de pausa para implementaciones de servicios de Amazon ECS

Los enlaces de pausa pausan una implementación de servicio de Amazon ECS en una etapa específica del ciclo de vida y esperan a que se llame a ContinueServiceDeployment antes de que avance la implementación. Use enlaces de pausa cuando se requiera aprobación manual o validación externa antes de que continúe una implementación.

Cómo funcionan los enlaces de pausa

Cuando una implementación llega a una etapa del ciclo de vida que tiene configurado un enlace de pausa, ocurre lo siguiente:

El hookId se puede obtener mediante una llamada a DescribeServiceDeployments. La respuesta incluye una matriz lifecycleHookDetails con el estado del enlace.

{
    "serviceDeployments": [
        {
            "lifecycleHookDetails": [
                {
                    "hookId": "ecs-pause-e7tK9G_WRJqNF_EOMjztDXfKenlJuEUVjsNStf4WLKw",
                    "targetType": "PAUSE",
                    "status": "AWAITING_ACTION",
                    "expiresAt": "2024-01-15T12:00:00Z",
                    "timeoutAction": "ROLLBACK"
                }
            ]
        }
    ]
}
    

Configuración de enlaces de pausa

En el siguiente ejemplo, se muestra una configuración de enlace de pausa en una definición de servicio que pausa la implementación después de que se completa el cambio de tráfico de prueba:

{
    "deploymentConfiguration": {
        "strategy": "BLUE_GREEN",
        "lifecycleHooks": [
            {
                "targetType": "PAUSE",
                "lifecycleStages": [
                    "POST_TEST_TRAFFIC_SHIFT"
                ],
                "timeoutConfiguration": {
                    "timeoutInMinutes": 10,
                    "action": "ROLLBACK"
                }
            }
        ]
    }
}
    

Campos de configuración

Restricciones

Continuación de una implementación en pausa

Cuando una implementación está en pausa, es decir, cuando el estado del enlace de pausa es AWAITING_ACTION, se debe llamar a ContinueServiceDeployment con hookId y la acción que se desea realizar.

Para continuar la implementación:

aws ecs continue-service-deployment \
    --hook-id ecs-pause-e7tK9G_WRJqNF_EOMjztDXfKenlJuEUVjsNStf4WLKw \
    --action CONTINUE
    

Para revertir la implementación:

aws ecs continue-service-deployment \
    --hook-id ecs-pause-e7tK9G_WRJqNF_EOMjztDXfKenlJuEUVjsNStf4WLKw \
    --action ROLLBACK
    

Para obtener más información, consulte Continuación de implementaciones de servicios.

Varios enlaces en la misma etapa

Cuando se configuran varios enlaces en la misma etapa del ciclo de vida, la implementación permanece en pausa hasta que se aplique la acción de continuar a todos los enlaces de esa etapa. Si algún enlace activa una reversión, se revierte toda la implementación, independientemente del estado de los demás enlaces en esa etapa.

Este comportamiento se aplica cuando los enlaces de Lambda y los enlaces de pausa se configuran en la misma etapa del ciclo de vida. La implementación solo avanza cuando todos los enlaces de esa etapa se han completado correctamente o se les ha aplicado la acción de continuar.

Todos los enlaces configurados en la misma etapa del ciclo de vida se ejecutan en paralelo.

Comportamiento de los tiempos de espera

Si no se llama a ContinueServiceDeployment antes de que venza el tiempo máximo de espera, Amazon ECS ejecuta la acción de tiempo de espera configurada:

Consulte el campo expiresAt de la matriz lifecycleHookDetails en la respuesta de DescribeServiceDeployments para ver cuándo vence el tiempo máximo de espera.

Enlaces de pausa con implementaciones lineales y canario

En las implementaciones lineales y canario, los enlaces de pausa configurados en PRE_PRODUCTION_TRAFFIC_SHIFT se invocan en cada paso de cambio de tráfico. Cada invocación genera un hookId único y se debe llamar a ContinueServiceDeployment para cada una.

Por ejemplo, una implementación lineal con 5 pasos de cambio de tráfico y un enlace de pausa en PRE_PRODUCTION_TRAFFIC_SHIFT se pausa 5 veces, una vez antes de cada paso. Cada pausa requiere una llamada independiente a ContinueServiceDeployment con el hookId correspondiente.

Eventos de EventBridge

Amazon ECS emite eventos de EventBridge con el tipo de detalle ECS Hook State Change a medida que los enlaces de pausa avanzan por su ciclo de vida. En la siguiente tabla, se describen los nombres de los eventos:

En el siguiente ejemplo, se muestra un evento de EventBridge emitido cuando un enlace de pausa está a la espera de acción:

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "ECS Hook State Change",
    "source": "aws.ecs",
    "account": "123456789012",
    "time": "2024-01-15T10:00:00Z",
    "region": "us-west-2",
    "detail": {
        "eventType": "INFO",
        "eventName": "HOOK_AWAITING_ACTION",
        "hookId": "ecs-pause-e7tK9G_WRJqNF_EOMjztDXfKenlJuEUVjsNStf4WLKw",
        "hookType": "PAUSE",
        "expiresAt": "2024-01-15T12:00:00Z",
        "lifecycleStage": "POST_TEST_TRAFFIC_SHIFT",
        "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/my-cluster",
        "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/my-cluster/my-service",
        "serviceDeploymentArn": "arn:aws:ecs:us-west-2:123456789012:service-deployment/my-cluster/my-service/EZe5RNVLH6PPzHXINuP28",
        "updatedAt": "2024-01-15T10:00:00Z"
    }
}