중지된 태스크 오류 해결
중지된 태스크 오류 해결
Amazon ECS 태스크가 예기치 않게 중지되는 경우가 있어요. 중지된 태스크의 오류를 확인하고 해결하는 방법을 알아보세요.
출처: 문서
본문
Amazon ECS 태스크가 중지될 때 태스크에는 중지 이유(stop reason)가 기록돼요. 컨테이너나 태스크 수준에서 발생한 오류를 확인하려면 태스크 상태와 중지 이유를 조회해요.
중지된 태스크 조회
중지된 태스크의 오류를 확인하려면:
- Amazon ECS 콘솔에서 중지된 태스크를 선택하고 Logs나 Details에서 중지 이유를 확인해요.
DescribeTasksAPI를 호출해stoppedReason과 컨테이너의reason필드를 확인해요.
일반적인 중지 오류
일반적인 중지 이유는 다음과 같아요:
- 리소스 초기화 오류 – 네트워크 인터페이스나 볼륨 연결 실패.
- 이미지 풀 실패 –
CannotPullContainerError: 잘못된 이미지 태그, 권한, 레지스트리 접근 문제. - 메모리 부족 – 태스크가 메모리 리밋을 초과.
- 컨테이너 시작 실패 –
CannotStartContainerError. - 필수 컨테이너 종료 – 필수(essential) 컨테이너가 종료되어 태스크가 중지.
각 오류의 원인과 해결 방법은 해당 오류 문서를 참조하세요. 이미지 풀 실패는 흔한 원인으로, 태스크 실행 역할의 레지스트리 권한과 이미지 태그를 확인하는 것이 좋아요.