Amazon ECS 배포 회로 차단기가 장애를 감지하는 방법

배포 회로 차단기는 작업이 안정 상태에 도달하는지 확인하는 롤링 업데이트 메커니즘입니다. 배포 회로 차단기에는 실패한 배포를 COMPLETED 상태의 배포로 자동 롤백하는 옵션이 있습니다. 회로 차단기가 실패를 계산하는 방법과 회로 차단기가 트리거되는 임계값을 사용자 지정하여 롤백 동작을 애플리케이션의 시작 특성 및 작업 실패에 대한 허용 오차와 일치하도록 할 수 있습니다.

서비스 배포의 상태가 변경되면 Amazon ECS는 서비스 배포 상태 변경 이벤트를 EventBridge로 전송합니다. 이를 통해 서비스 배포 상태를 프로그래밍 방식으로 모니터링할 수 있습니다. 자세한 내용은 Amazon ECS 서비스 배포 상태 변경 이벤트 섹션을 참조하세요. 수동 조치를 통해 배포를 시작할 수 있도록 eventName이 SERVICE_DEPLOYMENT_FAILED인 EventBridge 규칙을 생성하고 모니터링하는 것이 좋습니다. 자세한 내용은 Amazon EventBridge 사용 설명서의 EventBridge 시작하기를 참조하세요.

배포 회로 차단기는 배포가 실패한 것으로 확인하면 COMPLETED 상태의 최신 배포를 찾습니다. 그리고 이 배포를 롤백 배포로 사용합니다. 롤백이 시작되면 배포가 COMPLETED에서 IN_PROGRESS로 변경됩니다. 즉, 배포가 COMPLETED 상태에 도달하기까지 다른 롤백을 사용할 수 없습니다. 배포 회로 차단기가 COMPLETED 상태의 배포를 찾지 못하면 회로 차단기는 새 작업을 시작하지 않으며 배포가 중단됩니다.

서비스를 생성하면 스케줄러는 시작하지 못한 작업을 2단계로 추적합니다.

서비스에 배포 회로 차단기를 사용할 때 다음 사항을 고려해야 합니다. EventBridge에서 규칙을 생성합니다.

다음 create-service AWS CLI 예제에서는 배포 회로 차단기에 롤백 옵션이 사용된 경우 Linux 서비스를 생성하는 방법을 보여줍니다.

aws ecs create-service \
     --service-name MyService \
     --deployment-controller type=ECS \
     --desired-count 3 \
     --deployment-configuration "deploymentCircuitBreaker={enable=true,rollback=true}" \
     --task-definition sample-fargate:1 \
     --launch-type FARGATE \
     --platform-family LINUX \
     --platform-version 1.4.0 \
     --network-configuration "awsvpcConfiguration={subnets=[subnet-12344321],securityGroups=[sg-12344321],assignPublicIp=ENABLED}"

다음 create-service AWS CLI 예제에서는 고정 장애 횟수 5 및 누적 장애 추적을 사용하는 사용자 지정 배포 회로 차단기 구성으로 서비스를 생성하는 방법을 보여줍니다.

aws ecs create-service \
     --service-name MyService \
     --deployment-controller type=ECS \
     --desired-count 10 \
     --deployment-configuration "deploymentCircuitBreaker={enable=true,rollback=true,resetOnHealthyTask=false,thresholdConfiguration={type=COUNT,value=5}}" \
     --task-definition sample-fargate:1 \
     --launch-type FARGATE \
     --platform-family LINUX \
     --platform-version 1.4.0 \
     --network-configuration "awsvpcConfiguration={subnets=[subnet-12344321],securityGroups=[sg-12344321],assignPublicIp=ENABLED}"

예제:

배포 1은 COMPLETED 상태입니다.

배포 2를 시작할 수 없으므로 회로 차단기는 배포 1로 롤백합니다. 배포 1이 IN_PROGRESS 상태로 전환됩니다.

배포 3이 시작되고 COMPLETED 상태의 배포가 없으므로 배포 3은 롤백하거나 작업을 시작할 수 없습니다.

실패 임계값

배포 회로 차단기는 실패 임계값을 사용하여 배포를 FAILED 상태로 이동할 시기를 결정합니다. 실패 수 계산 방법과 임계값 자체를 모두 구성할 수 있습니다.

실패 수 계산 모드

resetOnHealthyTask 설정은 회로 차단기가 배포 중 작업 실패를 계산하는 방법을 제어합니다.

임계값 구성

thresholdConfiguration 설정은 회로 차단기가 트리거되는 시기를 정의합니다. 여기에는 임계값 계산 방법을 결정하는 type과 사용할 백분율 또는 수를 지정하는 value가 포함됩니다.

백분율 유형(BOUNDED_PERCENT 및 UNBOUNDED_PERCENT)의 경우, value의 유효한 범위는 1~100입니다. 배포 중에 Amazon ECS는 원하는 최신 서비스 수를 계산에 지속적으로 사용합니다.

BOUNDED_PERCENT이 임계값을 계산하는 방법

기본 BOUNDED_PERCENT 임계값 유형을 사용하는 경우 배포 회로 차단기는 다음 공식을 사용하여 임계값을 계산합니다.

Minimum threshold (3) <= (value/100) * desired task count => Maximum threshold (200)

계산 결과가 3보다 작으면 임계값은 3으로 설정됩니다. 결과가 200보다 크면 임계값이 200으로 설정됩니다. 그렇지 않으면 임계값이 계산된 값(반올림)으로 설정됩니다.

다음 표에는 기본값 50을 사용하는 예제가 나와 있습니다.

3 <= 0.5 * 1 => 200

3 <= 0.5 * 25 => 200

3 <= 0.5 * 400 => 200

3 <= 0.5 * 800 => 200

UNBOUNDED_PERCENT에서는 동일한 계산이 적용되지만 최소 및 최대 범위는 적용되지 않습니다. 예를 들어 원하는 개수가 800이고 값이 50인 서비스의 임계값은 400입니다.

배포 상태 검사에는 두 단계가 있습니다.

예를 들어, 임계값이 3인 경우 회로 차단기는 실패 횟수가 0으로 설정된 상태에서 시작됩니다. 작업이 RUNNING 상태에 도달하지 못하면 배포 회로 차단기가 실패 횟수를 하나씩 늘립니다. 실패 횟수가 3과 같아지면 배포가 FAILED로 표시됩니다.

롤백 옵션을 사용하는 방법에 대한 추가 예제는 Amazon ECS 배포 회로 차단기 발표를 참조하세요.