# Amazon ECS 컨테이너 메타데이터 파일
<a name="container-metadata"></a>

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

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

**Topics**
+ [컨테이너 메타데이터 파일 위치](#metadata-file-locations)
+ [Amazon ECS 컨테이너 메타데이터 켜기](enable-metadata.md)
+ [Amazon ECS 컨테이너 메타데이터 파일 형식](metadata-file-format.md)

## 컨테이너 메타데이터 파일 위치
<a name="metadata-file-locations"></a>

기본적으로 컨테이너 메타데이터 파일은 다음 호스트 및 컨테이너 경로에 작성됩니다.
+ **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 컨테이너 에이전트 구성](ecs-agent-config.md)을 참조하세요.
  + 컨테이너 경로: `/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
  ```