Amazon ECS 태스크 메타데이터 엔드포인트 버전 3

중요: 태스크 메타데이터 버전 3 엔드포인트는 더 이상 적극적으로 유지 관리되지 않아요. 최신 메타데이터 엔드포인트 정보를 얻으려면 태스크 메타데이터 버전 4 엔드포인트로 업데이트하는 것을 권장해요. 자세한 내용은 Amazon ECS task metadata endpoint version 4를 참고하세요. AWS Fargate에서 호스팅되는 Amazon ECS 태스크를 사용한다면 Amazon ECS task metadata endpoint version 3 for tasks on Fargate를 참고하세요.

출처: 문서

본문

Amazon ECS 컨테이너 에이전트 버전 1.21.0부터 에이전트는 태스크의 각 컨테이너에 ECS_CONTAINER_METADATA_URI라는 환경 변수를 주입해요. 태스크 메타데이터 버전 3 엔드포인트를 조회하면 다양한 태스크 메타데이터와 Docker 통계를 태스크에서 사용할 수 있어요. bridge 네트워크 모드를 사용하는 태스크의 경우 /stats 엔드포인트 조회 시 네트워크 메트릭을 사용할 수 있어요.

태스크 메타데이터 엔드포인트 버전 3 기능은 기본적으로 다음 태스크에서 활성화돼요.

플랫폼 버전 v1.3.0 이상을 사용하는 Fargate 태스크.
Amazon ECS 컨테이너 에이전트 최소 버전 1.21.0을 실행하는 Amazon EC2 Linux 인프라에서 실행되거나, Amazon ECS 컨테이너 에이전트 최소 버전 1.54.0을 실행하는 Amazon EC2 Windows 인프라에서 실행되고 awsvpc 네트워크 모드를 사용하는 EC2 태스크.

자세한 내용은 Amazon ECS Linux container instance management를 참고하세요. 에이전트를 최신 버전으로 업데이트하면 이전 컨테이너 인스턴스에도 이 기능에 대한 지원을 추가할 수 있어요. 자세한 내용은 Updating the Amazon ECS container agent를 참고하세요.

중요: v1.3.0 이전 플랫폼 버전을 사용하는 Fargate 태스크의 경우 태스크 메타데이터 버전 2 엔드포인트가 지원돼요. 자세한 내용은 Amazon ECS task metadata endpoint version 2를 참고하세요.

태스크 메타데이터 엔드포인트 버전 3 경로 (Task Metadata endpoint version 3 paths)

다음 태스크 메타데이터 엔드포인트를 컨테이너에서 사용할 수 있어요.

${ECS_CONTAINER_METADATA_URI} – 이 경로는 컨테이너에 대한 메타데이터 JSON을 반환해요.
${ECS_CONTAINER_METADATA_URI}/task – 이 경로는 태스크와 연결된 모든 컨테이너의 컨테이너 ID와 이름 목록을 포함해 태스크에 대한 메타데이터 JSON을 반환해요.