Amazon ECS 작업이 중지되는 이유는 무엇입니까?

해결 방법

DescribeTasks API를 사용하여 중지된 작업의 세부 정보를 확인합니다. 작업 문제를 해결하려면 중지된 이유와 종료 코드를 확인하십시오. 중지된 작업의 세부 정보는 API 결과에 1시간 동안만 표시됩니다. 중지된 작업의 세부 정보를 보는 데 더 많은 시간을 사용하려면 GitHub 웹 사이트에서 amazon-ecs-stopped-tasks-cwlogs 템플릿을 사용하십시오.

작업이 중지된 이유

작업의 필수 컨테이너가 종료됨

필수 컨테이너가 종료된 경우 다음 종료 코드 중 하나를 사용하여 문제를 해결하십시오.

• 0 종료 코드는 진입점, 성공 또는 CMD가 완료되고 컨테이너가 중지될 때 발생합니다.
• 1 종료 코드는 애플리케이션 오류가 있을 때 발생합니다. 이 종료 코드 문제를 해결하려면 애플리케이션 로그를 검토하십시오.
• 137 종료 코드는 사용자가 기본값인 30초 이내에 SIGTERM에 응답하지 않고 Amazon ECS가 컨테이너에 대해 작업을 강제로 종료(SIGKILL)할 때 발생합니다. 기본 30초 기간을 변경하려면 ECS 컨테이너 에이전트의 ECS_CONTAINER_STOP_TIMEOUT 파라미터를 업데이트합니다.
  참고: 이 종료 코드는 메모리 부족(OOM) 오류로 인해 발생할 수도 있습니다. 리소스 사용량을 확인하려면 Amazon ECS의 Amazon CloudWatch 지표를 검토하십시오.
• 139 종료 코드는 애플리케이션이 사용할 수 없는 메모리 AWS 리전에 액세스하려고 할 때 발생합니다. 이 종료 코드는 설정되지 않았거나 유효하지 않은 환경 자리 표시자로 인해 세분화 오류가 발생하는 경우에도 발생합니다. 이 문제를 해결하려면 Lambda 함수에 대한 Amazon ECS CloudWatch 로그를 검토하십시오.
• 143 종료 코드는 컨테이너가 정상 종료 경고를 수신하고 Amazon ECS가 컨테이너를 종료했을 때 발생합니다.
• 255 종료 코드는 오류로 인해 컨테이너의 ENTRYPOINT CMD 명령이 실패했을 때 발생합니다. 오류로 인해 컨테이너가 실패했는지 확인하려면 CloudWatch 로그를 검토하십시오.

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

CannotPullContainerError

이 오류는 Amazon ECS에서 지정된 컨테이너 이미지를 검색할 수 없기 때문에 작업 시작에 실패했을 때 발생합니다.

Amazon Elastic Compute Cloud(Amazon EC2) 시작 유형 작업에서 이 문제를 해결하려면 Amazon ECS에서 EC2 작업을 시작할 때 ‘CannotPullContainerError’ 오류를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

Fargate 시작 유형을 사용하는 Amazon ECS 작업에서 이 문제를 해결하려면 Fargate의 Amazon ECS 작업에 발생한 ‘cannotpullcontainererror’ 오류를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

작업의 Elastic Load Balancer 상태 확인 실패

EC2 시작 유형을 사용하는 작업에서 이 문제를 해결하려면 Amazon EC2 시작 유형을 사용하는 Amazon ECS 작업이 Application Load Balancer 상태 확인을 통과하도록 하려면 어떻게 해야 합니까?를 참조하십시오.

Fargate 시작 유형을 사용하는 작업에서 이 문제를 해결하려면 Fargate에서 Amazon ECS 작업의 상태 확인 실패 문제를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

컨테이너 상태 확인 실패

HealthCheck API 또는 Dockerfile에서 상태 확인을 정의합니다. 자세한 내용은 Docker 웹 사이트의 HEALTHCHECK를 참조하십시오.

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

(인스턴스 i-##)(포트 #) 비정상(상태 확인 실패 이유)

이 오류는 비정상 Amazon EC2 인스턴스가 지정된 포트의 상태 확인에 응답하지 않을 때 발생합니다.

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

• 컨테이너 인스턴스에 연결된 보안 그룹이 필요한 트래픽을 허용하는지 확인합니다.
• 다음 명령을 실행하여 백엔드가 지연 없이 응답하는지 확인합니다.

  curl -iv localhost:container-port/path

  참고: container-port를 컨테이너 포트로, path를 상태 확인 경로로 바꾸십시오.
• 응답 시간 제한 값을 기본값인 30초에서 늘립니다. ECS 컨테이너 에이전트의 ECS_CONTAINER_STOP_TIMEOUT 파라미터를 업데이트합니다.

이 오류 메시지에 대한 자세한 내용은 Network Load Balancer의 로그 액세스를 참조하십시오.

서비스 ABCService: ECS가 작업을 호스팅하는 기본 인프라에 대한 유지 관리를 수행하고 있음

이 오류는 Amazon ECS가 애플리케이션 컨테이너를 실행하는 AWS Fargate 서버에서 유지 관리를 수행할 때 발생합니다. 그에 따라 Amazon ECS 서비스를 일시적으로 사용할 수 없게 됩니다.

자세한 내용은 Amazon ECS에서 AWS Fargate에 대한 작업 사용 중지 및 유지 관리를 참조하십시오.

독립형 작업의 경우 Fargate에서 실행되는 작업에 대한 Amazon ECS 작업 사용 중지 알림에 대해 조치를 취하려면 어떻게 해야 합니까?를 참조하십시오.

Amazon ECS 서비스 스케일링 이벤트 활성화

Amazon ECS 서비스 스케일링 이벤트 도중 스케일링 정책으로 인해 서비스에서 실행되는 작업의 수가 줄어들기 때문에 작업이 중지됩니다. 그러면 Amazon ECS는 새로 지정된 수에 도달할 때까지 작업을 중지합니다. 이 작업은 일반적으로 수요가 감소하고 Amazon ECS에서 워크로드를 처리하는 데 필요한 작업 수가 적을 때 발생합니다.

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

• 서비스 또는 작업의 변경에 대한 CloudWatch 경보를 만듭니다.
• 작업에 영향을 미칠 수 있는 예약된 배포를 검토합니다.

서비스 오토 스케일링 또는 배포로 인한 스케일 인 이벤트 종료에서 작업을 보호하려면 Amazon ECS Task Scale-in Protection을 사용합니다.

자세한 내용은 Amazon ECS 서비스의 예약된 규모 조정 작업을 보고 관리하려면 어떻게 해야 합니까?를 참조하십시오.

사용자가 작업을 중지함

작업에서 StopTask API를 수신했습니다. 호출을 시작한 사용자를 식별하려면 AWS CloudTrail의 StopTask에서 userIdentity 정보를 확인하십시오.

ResourceInitializationError: 오류

다양한 ResourceInitialization 오류 메시지 및 해결 단계는 Amazon ECS ResourceInitializatioError 오류 해결을 참조하십시오.

‘ResourceInitializationError: unable to pull secrets or registry auth’ 오류를 해결하려면 ECS 작업에 대한 보안 암호를 가져오거나 Amazon ECR 인증을 검색하려고 할 때 발생하는 ‘ResourceInitializationError’를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

‘ResourceInitializationError: failed to validate logger args’ 오류를 해결하려면 Amazon ECS에서 ‘ResourceInitializationError: failed to validate logger args’ 오류를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

SpotInterruptionError

SpotInterruptionError 오류에 대한 자세한 내용은 Amazon ECS SpotInterruption 오류 해결을 참조하십시오.

이 오류를 해결하려면 AWS Fargate 스팟 작업에서 스팟 종료 알림을 처리하려면 어떻게 해야 합니까?를 참조하십시오.

OutOfMemoryError

이 오류는 컨테이너의 프로세스가 작업 정의에 할당한 것보다 더 많은 메모리를 사용하기 때문에 컨테이너가 종료될 때 발생합니다.

이 오류를 해결하려면 Amazon ECS에서 OutOfMemory 오류를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

오류 메시지

작업이 중지될 때 오류 메시지가 표시되면 오류에 따라 다음 문제 해결 작업을 수행하십시오.

No Container Instances were found in your cluster

이 문제를 해결하려면 컨테이너 인스턴스를 시작합니다.

클러스터의 컨테이너 인스턴스를 검토하려면 다음 단계를 완료하십시오.

1. Amazon ECS 콘솔을 엽니다.
2. 탐색 창에서 클러스터를 선택합니다.
3. 해당 클러스터를 선택합니다.
4. 인프라 탭을 선택합니다.
5. 컨테이너 인스턴스 섹션을 검토합니다.

컨테이너 인스턴스가 없는 경우 Amazon EC2 인스턴스를 Amazon ECS 클러스터에 조인할 수 없는 이유는 무엇입니까?를 참조하십시오.

InvalidParameterException

이 오류 메시지를 해결하려면 TaskDefinition의 파라미터가 존재하고 ARN이 올바른지 확인하십시오. 작업 역할 및 작업 실행 역할에 필요한 권한이 있는지 확인하십시오.

You've reached the limit of the number of tasks that you can run concurrently

이 오류는 Amazon ECS 서비스 할당량을 초과할 때 발생합니다. 이 문제를 해결하려면 Amazon ECS 서비스 할당량 문제를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

관련 정보

Amazon ECS에서 중지되는 작업 오류 해결

Amazon ECS에서 중지되는 작업 오류 보기