Amazon ECS 서비스 배포 훅 상태 변경 이벤트

Amazon ECS는 detail type이 ECS Hook State Change인 훅 상태 변경 이벤트를 보냅니다. 이 글에서는 배포 수명 주기 훅이 상태를 변경할 때 발생하는 이벤트에 대해 알아봅니다.

출처: 문서

본문

Amazon ECS는 detail type이 ECS Hook State Change인 훅 상태 변경 이벤트를 보냅니다. 이 이벤트는 배포 수명 주기 훅(deployment lifecycle hook)이 상태를 변경할 때 발생합니다. 다음은 Amazon ECS 훅 상태 변경 이벤트에 대한 EventBridge 규칙을 만드는 데 사용되는 이벤트 패턴입니다.

{
    "source": [
        "aws.ecs"
    ],
    "detail-type": [
        "ECS Hook State Change"
    ]
}

다음은 훅 상태 변경 이벤트들입니다:

HOOK_IN_PROGRESS — 훅이 진행 중입니다.
HOOK_AWAITING_ACTION — 일시 중지(pause) 훅이 시작되었고 완료하려면 작업이 필요합니다. 배포를 계속하거나 롤백하려면 ContinueServiceDeployment를 호출하세요.
HOOK_SUCCEEDED — 훅이 성공적으로 완료되었습니다. 일시 중지 훅의 경우 ContinueServiceDeployment가 CONTINUE 작업으로 호출되었음을 의미합니다.
HOOK_FAILED — 훅이 실패했습니다. 일시 중지 훅의 경우 ContinueServiceDeployment가 ROLLBACK 작업으로 호출되었음을 의미합니다.
HOOK_TIMED_OUT — 훅이 완료되지 않고 시간 초과되었습니다.

예시: 작업 대기 중인 훅 이벤트 (Example hook awaiting action event)

다음은 일시 중지 훅이 시작되고 작업을 기다리고 있을 때의 예시 이벤트입니다.

{
    "version": "0",
    "id": "3329f79b-3dca-07f8-b1c2-5fe99f0b5e87",
    "detail-type": "ECS Hook State Change",
    "source": "aws.ecs",
    "account": "123456789012",
    "time": "2026-03-05T15:54:41Z",
    "region": "us-west-2",
    "resources": ["arn:aws:ecs:us-west-2:123456789012:service-deployment/my-cluster/my-service/0EYSiB0qap8xf0N76FsbE"],
    "detail": {
        "eventType": "INFO",
        "eventName": "HOOK_AWAITING_ACTION",
        "hookId": "ecs-pause-e7tK9G_WRJqNF_EOMjztDXfKenlJuEUVjsNStf4WLKw",
        "hookType": "PAUSE",
        "expiresAt": "2026-03-05T16:04:41Z",
        "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/0EYSiB0qap8xf0N76FsbE",
        "updatedAt": "2026-03-05T15:54:41.618059641Z"
    }
}

더 알아보기 (Learn more)

배포 훅과 EventBridge 규칙에 대한 자세한 내용은 AWS 개발자 가이드의 관련 문서를 참고하세요.