AWS Builder Center: Learn, Build and Connect with builders in the AWS community

AWS Builder Center is the official home for builders on AWS. Share and read what others are working on, follow people who inspire you, explore training and workshops, and find tools to support what you're building.

Amazon ECS 배포 회로 차단기가 배포 상태를 FAILED로 설정한 이유는 무엇입니까?

3분 분량

Amazon Elastic Container Service(Amazon ECS) 배포 회로 차단기가 배포 상태를 FAILED로 설정했습니다. 배포 실패의 원인을 해결하고 싶습니다.

간략한 설명

배포의 연속 실패 횟수가 정의된 임계값에 도달하면 배포 회로 차단기가 배포 상태를 FAILED로 설정합니다. 다음과 같은 오류 메시지가 표시될 수 있습니다.

"Resource handler returned message: "Error occurred during operation 'ECS Deployment Circuit Breaker was triggered'." (RequestToken: xxxxxxxx-xxxx-xxxxxx-xxxxxxx, HandlerErrorCode: GeneralServiceException)"

다음과 같은 문제로 인해 배포가 실패할 수 있습니다.

컨테이너가 상태 확인에 실패했습니다.
대상 그룹이 Application Load Balancer 상태 확인에 실패했습니다.
구성할 때 AWS Cloud Map 서비스 상태 확인에 실패했습니다.
Amazon Elastic Container Registry(Amazon ECR) 이미지가 존재하지 않습니다.
컨테이너 인스턴스가 모든 작업 배치 기준을 충족하지 못했습니다.
새 배포의 작업이 연속해서 중지되거나 시작되지 않았습니다.

해결 방법

이 문제를 해결하려면 Amazon ECS 서비스 이벤트 메시지를 확인하여 Amazon ECS에서 회로 차단기를 활성화한 이유를 파악합니다. 그런 다음 사유에 따라 다음과 같은 조치를 취합니다.

컨테이너 상태 확인 실패 해결

작업의 Amazon ECS 컨테이너가 상태 확인을 통과할 수 없는 경우 다음 오류 메시지가 표시됩니다.

"(service AWS-Service) (task ff3e71a4-d7e5-428b-9232-2345657889) failed container health checks."

이 문제를 해결하려면 다음 작업을 수행하십시오.

Amazon ECS 컨테이너 로그에서 애플리케이션 오류 또는 잘못된 구성을 확인합니다.
상태 확인 구성이 애플리케이션의 시작 시간 및 동작과 일치하는지 확인합니다.

컨테이너 상태 확인 실패를 해결하려면 Amazon ECS 작업의 컨테이너 상태 확인 실패 문제를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

Application Load Balancer 상태 확인 실패 해결

이 문제를 해결하려면 다음 작업을 수행하십시오.

대상 그룹의 상태 확인 설정을 올바르게 구성했는지 확인합니다.
애플리케이션이 지정된 상태 확인 요청에 올바르게 응답하는지 확인합니다.
상태 확인 요청을 차단하는 네트워크 또는 보안 그룹 문제가 없는지 확인합니다.

Application Load Balancer 상태 확인 실패를 해결하려면 Application Load Balancer의 상태 확인 실패 문제를 어떻게 해결합니까?를 참조하십시오.

참고: Amazon ECS는 상태 확인 실패가 연속되는 경우에만 롤백을 시작합니다.

AWS Cloud Map 상태 확인 실패 해결

외부 상태 확인 또는 사용자 지정 상태 확인를 사용하여 AWS Cloud Map을 구성한 경우, 애플리케이션 엔드포인트가 정상 상태인지 검토하십시오.

애플리케이션 엔드포인트의 정상 여부를 판단하는 방법은 Amazon Route 53에서 상태 확인의 정상 여부를 판단하는 방법을 참조하십시오. AWS Cloud Map 상태 확인에 대한 자세한 내용은 AWS Cloud Map 서비스 상태 확인 구성을 참조하십시오.

누락된 Amazon ECR 이미지 문제 해결

이 문제를 해결하려면 Amazon ECS 클러스터에서 작업을 시작하지 못할 때 "Image does not exist" 오류를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

작업 배치 기준 문제 해결

이 문제를 해결하려면 Amazon ECS에서 "no container instance met all of its requirements" 오류를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

작업 시작 실패 해결

이 문제를 해결하려면 다음 단계를 완료하십시오.

Amazon CloudWatch Logs Insights를 사용하여 로그를 검토하고 DescribeTasks API를 사용하여 작업의 stoppedReason를 가져옵니다.
클러스터에 활성 인스턴스가 있는지 확인합니다.
작업의 CPU 또는 메모리가 컨테이너 인스턴스의 CPU 또는 메모리를 초과하지 않는지 확인합니다.

작업 시작 실패 문제를 해결하려면 Amazon ECS 작업이 중지되는 이유는 무엇입니까?를 참조하십시오. 시작되지 않는 작업 문제를 해결하려면 컨테이너가 종료될 때 Amazon ECS 작업이 중단되거나 시작되지 않는 문제를 해결하려면 어떻게 해야 합니까?를 참조하십시오.