AWS CloudFormation
사용 설명서 (API 버전 2010-05-15)

AWS::ECS::TaskDefinition HealthCheck

HealthCheck 속성은 컨테이너 상태 검사를 나타내는 객체를 지정합니다. 컨테이너 정의에 지정된 상태 확인 파라미터는 컨테이너 이미지(상위 이미지에 지정된 컨테이너 이미지 또는 이미지의 도커 파일에 있는 컨테이너 이미지)에 존재하는 도커 상태 확인을 재정의합니다.

다음은 컨테이너 상태 확인 지원에 대한 참고 사항입니다.

  • 컨테이너 상태 확인을 위해서는 버전이 1.17.0 이상인 Amazon ECS 컨테이너 에이전트가 필요합니다. 자세한 내용은 Amazon ECS 컨테이너 에이전트 업데이트를 참조하십시오.

  • 버전이 1.1.0 이상인 플랫폼을 사용할 경우, Fargate 작업에서 컨테이너 상태 검사가 지원됩니다. 자세한 내용은 AWS Fargate 플랫폼 버전을 참조하십시오.

  • Classic Load Balancer를 사용하도록 구성된 서비스에 포함되는 작업일 때는 컨테이너 상태 검사가 지원되지 않습니다.

구문

AWS CloudFormation 템플릿에서 이 개체를 선언하려면 다음 구문을 사용합니다.

JSON

{ "Command" : [ String, ... ], "Interval" : Integer, "Retries" : Integer, "StartPeriod" : Integer, "Timeout" : Integer }

YAML

Command: - String Interval: Integer Retries: Integer StartPeriod: Integer Timeout: Integer

Properties

Command

상태가 정상인지 여부를 판단하기 위해 컨테이너가 실행하는 명령을 나타내는 문자열 배열입니다. 명령 인수를 직접 실행하려면 문자열 배열이 CMD으로 시작해야 하고 컨테이너의 기본 셸에서 명령을 실행하려면 CMD-SHELL로 시작해야 합니다. 예:

[ "CMD-SHELL", "curl -f http://localhost/ || exit 1" ]

종료 코드 0은 성공을 나타내고, 0이 아닌 종료 코드는 실패를 나타냅니다. 자세한 내용은 Docker 원격 API에서 컨테이너 생성 단원의 HealthCheck를 참조하십시오.

Required: 예

Type: String 목록

Update requires: Replacement

Interval

각 상태 확인 실행 간의 시간(초)입니다. 5초부터 300초까지 지정할 수 있습니다. 기본 값은 30초입니다.

Required: 아니요

Type: 정수

Update requires: Replacement

Retries

컨테이너 상태가 비정상이라고 간주되기 전에 실패한 상태 확인을 재시도하는 횟수입니다. 1부터 10까지 재시도 횟수를 지정할 수 있습니다. 기본값은 3입니다.

Required: 아니요

Type: 정수

Update requires: Replacement

StartPeriod

실패한 상태 확인이 최대 재시도 횟수에 포함되기 전에 컨테이너에 부트스트랩 시간이 제공되는 유예 기간 옵션입니다. 0초부터 300초까지 지정할 수 있습니다. 기본적으로 startPeriod는 비활성화되어 있습니다.

참고

상태 검사가 startPeriod 내에 성공한 경우 컨테이너는 정상으로 간주되고 모든 후속 실패는 최대 재시도 횟수에 포함됩니다.

Required: 아니요

Type: 정수

Update requires: Replacement

Timeout

실패로 간주되기 전에 상태 확인이 성공하기까지의 대기 시간(초)입니다. 2초부터 60초까지 지정할 수 있습니다. 기본값은 5입니다.

Required: 아니요

Type: 정수

Update requires: Replacement

이 페이지에서: