Fargate 태스크를 위한 Amazon ECS 태스크 메타데이터 엔드포인트 버전 4
Fargate 태스크를 위한 Amazon ECS 태스크 메타데이터 엔드포인트 버전 4
AWS Fargate에서 호스팅되는 태스크에 대한 태스크 메타데이터 엔드포인트 버전 4와 그 경로를 알아봐요.
출처: 문서
본문
중요 — Amazon EC2 인스턴스에서 호스팅되는 Amazon ECS 태스크를 사용한다면 Amazon ECS task metadata endpoint를 참고하세요.
Fargate 플랫폼 버전 1.4.0부터 ECS_CONTAINER_METADATA_URI_V4라는 환경 변수가 태스크의 각 컨테이너에 주입돼요. 태스크 메타데이터 엔드포인트 버전 4를 쿼리하면 태스크에 다양한 태스크 메타데이터와 Docker stats를 사용할 수 있어요.
태스크 메타데이터 엔드포인트 버전 4는 버전 3 엔드포인트처럼 작동하지만 컨테이너와 태스크에 대한 추가 네트워크 메타데이터를 제공해요. /stats 엔드포인트를 쿼리할 때도 추가 네트워크 지표를 사용할 수 있어요.
태스크 메타데이터 엔드포인트는 플랫폼 버전 1.4.0 이상을 사용하는 AWS Fargate에서 실행되는 모든 Amazon ECS 태스크에 대해 기본적으로 켜져 있어요.
참고 — 향후 새 태스크 메타데이터 엔드포인트 버전을 만들 필요가 없도록 추가 메타데이터가 버전 4 출력에 추가될 수 있어요. 기존 메타데이터를 제거하거나 메타데이터 필드 이름을 변경하지 않을 거예요.
Fargate 태스크 메타데이터 엔드포인트 버전 4 경로 (Paths)
다음 태스크 메타데이터 엔드포인트를 컨테이너에서 사용할 수 있어요.
- ${ECS_CONTAINER_METADATA_URI_V4} - 이 경로는 컨테이너의 메타데이터를 반환해요.
- ${ECS_CONTAINER_METADATA_URI_V4}/task - 이 경로는 태스크에 연결된 모든 컨테이너의 컨테이너 ID와 이름 목록을 포함해 태스크의 메타데이터를 반환해요. 이 엔드포인트의 응답에 대한 자세한 내용은 Amazon ECS task metadata v4 JSON response for tasks on Fargate 참고.
- ${ECS_CONTAINER_METADATA_URI_V4}/stats - 이 경로는 Docker 컨테이너의 Docker stats를 반환해요. 반환된 각 stats에 대한 자세한 내용은 Docker API 문서의 ContainerStats 참고.
- 참고 — AWS Fargate의 Amazon ECS 태스크는 컨테이너 stats를 반환하기 전에 컨테이너가 약 1초간 실행되어야 해요.
- ${ECS_CONTAINER_METADATA_URI_V4}/task/stats - 이 경로는 태스크에 연결된 모든 컨테이너의 Docker stats를 반환해요.