오류로 인해 중지된 작업 확인 - Amazon Elastic Container Service
추가 리소스

오류로 인해 중지된 작업 확인

태스크를 시작하는 데 문제가 있는 경우, 오류 때문에 작업이 중지된 것일 수 있습니다. 예를 들면, 작업 실행 시 작업이 PENDING 상태를 표시한 후 사라지는 경우입니다. 이와 같은 작업 중지 오류는 Amazon ECS 콘솔에서 중지된 태스크를 확인하고 오류 메시지를 검사하여 확인할 수 있습니다.

중요

또한 Amazon ECS는 작업 상태 변경 이벤트를 EventBridge로 전송합니다. 이 이벤트를 통해 Amazon ECS 콘솔의 보기에서 중지된 작업이 만료되었는지 확인할 수 있습니다. 자세한 내용은 작업 상태 변경 이벤트 섹션을 참조하세요.

1시간 이상 중지된 태스크를 조사하는 방법에 대한 자세한 내용은 GitHub 웹사이트의 CloudWatch Logs의 ECS 중지된 태스크를 참조하세요.

New console

새로운 AWS Management Console

다음 단계를 사용하여 컨테이너 인스턴스를 새 AWS Management Console을 사용한 드레이닝으로 설정할 수 있습니다.

  1. https://console.aws.amazon.com/ecs/에서 Amazon ECS 콘솔을 엽니다.

  2. 탐색 창에서 클러스터(Clusters)를 선택합니다.

  3. 클러스터(Clusters) 페이지에서 클러스터를 선택합니다.

  4. 클러스터: name(Cluster : name) 페이지에서 태스크(Tasks) 탭을 선택합니다.

  5. 검사할 중지된 태스크를 선택합니다.

  6. 상태(Status) 섹션에서 중단 사유(Stopped reason) 필드를 검사하여 태스크가 중지된 이유를 확인합니다.

Classic console

  1. https://console.aws.amazon.com/ecs/에서 Amazon ECS 콘솔을 엽니다.

  2. 클러스터 페이지에서 중지된 작업이 상주하는 클러스터를 선택합니다.

  3. 클러스터: clustername 페이지에서 작업(Tasks)을 선택합니다.

  4. 원하는 작업 상태(Desired task status) 테이블 헤더에서 중지됨(Stopped)을 선택한 후, 중지된 태스크를 선택하여 검사합니다. 가장 최근에 중지된 작업이 제일 먼저 나열됩니다.

  5. 세부 정보(Details) 섹션에서 중단 사유(Stopped reason) 필드를 검사하여 작업이 중지된 이유를 확인합니다.

    작업 중지 이유

    몇 가지 가능한 이유와 설명이 아래 나열되어 있습니다.

    (elb elb-name)에서 작업이 ELB 상태 확인에 실패했습니다

    현재 작업이 작업의 서비스에 연결된 로드 밸런서의 Elastic Load Balancing 상태 확인에 실패했습니다. 자세한 내용은 서비스 로드 밸런서 문제 해결 섹션을 참조하세요.

    (deployment deployment-id)에 의해 조정 활동 시작됨

    원하는 안정적 서비스 수를 줄일 경우, 원하는 수에 도달하려면 일부 태스크를 중지해야 합니다. 서비스 축소에 의해 중지되는 작업에는 이런 중지 이유가 있습니다.

    호스트 EC2(인스턴스 id) 중지/종료됨

    작업이 실행 중인 컨테이너 인스턴스를 중지 또는 종료하는 경우, 해당 작업에 이 중지 이유가 주어집니다.

    사용자에 의해 컨테이너 인스턴스 등록이 강제로 취소됨

    작업이 실행 중인 컨테이너 인스턴스의 등록을 강제로 취소하는 경우, 해당 작업에 이 중지 이유가 주어집니다.

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

    태스크 정의에서 essential로 표시된 컨테이너가 종료되거나 사라질 경우, 작업이 중지될 수 있습니다. 필수 컨테이너 종료가 중지된 작업의 원인인 경우, 단계 6에서 컨테이너 중지 이유에 관해 더 많은 정보를 제공할 수 있습니다.

  6. 중지된 컨테이너가 있다면 컨테이너를 확장해 상태 사유(Status reason) 행에서 작업 상태 변경의 원인을 검사합니다.

    컨테이너 중지 오류

    앞의 예제에서 컨테이너 이미지 이름을 찾을 수 없습니다. 이 오류는 이미지 이름을 잘못 입력하는 경우에 발생할 수 있습니다.

    이 검사가 충분한 정보를 제공하지 않는 경우, SSH를 사용해 컨테이너 인스턴스에 연결하여 로컬에서 Docker 컨테이너를 검사할 수 있습니다. 자세한 정보는 Docker 컨테이너 검사을 참조하세요.

AWS CLI

  1. 클러스터의 태스크를 나열합니다. 결과에는 작업의 Amazon 리소스 이름(ARN)이 포함되어 있으며 이를 통해 태스크를 설명해야 합니다.

    aws ecs list-tasks \
     --cluster cluster_name \
     --desired-status STOPPED \
     --region us-west-2

  2. 중지된 태스크를 설명하여 응답에서 stoppedReason을 검색합니다.

    aws ecs describe-tasks \
     --cluster cluster_name \
     --tasks arn:aws:ecs:us-west-2:account_id:task/cluster_name/task_ID \
     --region us-west-2

추가 리소스

다음 페이지는 오류 코드에 대한 추가 정보를 제공합니다.