Amazon ECS 컨테이너 메타데이터 파일

1.15.0 버전의 Amazon ECS 컨테이너 에이전트를 비롯해 컨테이너 또는 호스트 컨테이너 인스턴스 내에서 다양한 컨테이너 메타데이터를 얻을 수 있습니다. 이 기능을 활성화하여 컨테이너 또는 호스트 컨테이너 인스턴스 내에서 태스크, 컨테이너 및 컨테이너 인스턴스에 대한 정보를 쿼리할 수 있습니다. 메타데이터 파일은 호스트 인스턴스에서 생성되고 컨테이너에 Docker 볼륨으로 마운트되므로 AWS Fargate에서 작업을 호스팅할 때는 사용할 수 없습니다.

컨테이너 메타데이터 파일은 컨테이너가 정리될 때 호스트 인스턴스에서 정리됩니다. 이런 일이 발생하면 ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION 컨테이너 에이전트 변수를 사용하여 조정할 수 있습니다. 자세한 설명은 자동 태스크 및 이미지 정리 섹션을 참조하세요.

주제

• 컨테이너 메타데이터 파일 위치
• Amazon ECS 컨테이너 메타데이터 활성화
• 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