Amazon ECS 컨테이너 메타데이터 파일
1.15.0 버전의 Amazon ECS 컨테이너 에이전트를 비롯해 컨테이너 또는 호스트 컨테이너 인스턴스 내에서 다양한 컨테이너 메타데이터를 얻을 수 있습니다. 이 기능을 활성화하여 컨테이너 또는 호스트 컨테이너 인스턴스 내에서 태스크, 컨테이너 및 컨테이너 인스턴스에 대한 정보를 쿼리할 수 있습니다. 메타데이터 파일은 호스트 인스턴스에서 생성되고 Docker 볼륨으로 탑재되므로 태스크가 AWS Fargate에서 호스팅될 때는 사용할 수 없습니다.
컨테이너 메타데이터 파일은 컨테이너가 정리될 때 호스트 인스턴스에서 정리됩니다. 이런 일이 발생하면 ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION
컨테이너 에이전트 변수를 사용하여 조정할 수 있습니다. 자세한 내용은 자동 Amazon ECS 태스크 및 이미지 정리 단원을 참조하십시오.
컨테이너 메타데이터 파일 위치
기본적으로 컨테이너 메타데이터 파일은 다음 호스트 및 컨테이너 경로에 작성됩니다.
-
Linux 인스턴스의 경우:
-
호스트 경로:
/var/lib/ecs/data/metadata/
cluster_name
/task_id
/container_name
/ecs-container-metadata.json참고
Linux 호스트 경로에서는 에이전트가 시작될 때 기본 데이터 디렉터리 마운트 경로(
/var/lib/ecs/data
)를 사용하는 것으로 가정합니다. Amazon ECS 최적화 AMI(또는 컨테이너 에이전트를 시작하고 유지하는ecs-init
패키지)를 사용하지 않는 경우, 컨테이너 에이전트의 상태 파일이 있는 호스트 경로에ECS_HOST_DATA_DIR
에이전트 구성 변수를 설정해야 합니다. 자세한 정보는 Amazon ECS 컨테이너 에이전트 구성을 참조하세요. -
컨테이너 경로:
/opt/ecs/metadata/
random_ID
/ecs-container-metadata.json
-
-
Windows 인스턴스의 경우:
-
호스트 경로:
C:\ProgramData\Amazon\ECS\data\metadata\
task_id
\container_name
\ecs-container-metadata.json -
컨테이너 경로:
C:\ProgramData\Amazon\ECS\metadata\
random_ID
\ecs-container-metadata.json
-
그러나 손쉬운 액세스를 위해 컨테이너 메타데이터 파일 위치는 컨테이너 내부에 ECS_CONTAINER_METADATA_FILE
환경 변수로 설정됩니다. 다음 명령을 사용하여 컨테이너 내부에서 파일 콘텐츠를 읽을 수 있습니다.
-
Linux 인스턴스의 경우:
cat $ECS_CONTAINER_METADATA_FILE
-
Windows 인스턴스의 경우(PowerShell):
Get-Content -path $env:ECS_CONTAINER_METADATA_FILE