Arquivo de metadados de contêiner do Amazon ECS

A partir da versão 1.15.0 do agente de contêiner do Amazon ECS, vários metadados de contêiner estão disponíveis em seus contêineres ou na instância de contêiner do host. Ao habilitar esse recurso, é possível consultar as informações sobre uma tarefa, um contêiner e uma instância de contêiner de dentro do contêiner ou da instância de contêiner do host. O arquivo de metadados é criado na instância do host e montado no contêiner como um volume do Docker e, portanto, não está disponível quando uma tarefa é hospedada no AWS Fargate.

O arquivo de metadados do contêiner é limpo na instância do host quando o contêiner é limpo. É possível ajustar quando isso acontece com a variável do agente de contêiner ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION. Para ter mais informações, consulte Limpeza automatizada de tarefa e de imagem.

Tópicos

• Locais do arquivo de metadados do contêiner
• Ativando os metadados de contêineres do Amazon ECS
• Formato de arquivo de metadados de contêiner do Amazon ECS

Locais do arquivo de metadados do contêiner

Por padrão, o arquivo de metadados do contêiner é gravado nos seguintes caminhos de host e contêiner.

• Para instâncias do Linux:

  • Caminho do host: /var/lib/ecs/data/metadata/cluster_name/task_id/container_name/ecs-container-metadata.json

    nota

    O caminho do host Linux pressupõe que o caminho padrão de montagem do diretório de dados (/var/lib/ecs/data) é usado quando o agente é iniciado. Se você não estiver usando a AMI otimizada para Amazon ECS (ou o pacote ecs-init para iniciar e manter o agente de contêiner), defina a variável de configuração do agente ECS_HOST_DATA_DIR para o caminho do host em que está localizado o arquivo de estado do agente de contêiner. Para ter mais informações, consulte Configuração do agente de contêiner do Amazon ECS.

  • Caminho do contêiner: /opt/ecs/metadata/random_ID/ecs-container-metadata.json

• Para instâncias Windows:

  • Caminho do host: C:\ProgramData\Amazon\ECS\data\metadata\task_id\container_name\ecs-container-metadata.json

  • Caminho do contêiner: C:\ProgramData\Amazon\ECS\metadata\random_ID\ecs-container-metadata.json

No entanto, para acesso fácil, o local do arquivo de metadados do contêiner é definido na variável de ambiente ECS_CONTAINER_METADATA_FILE, dentro do contêiner. É possível ler o conteúdo do arquivo de dentro de contêiner com o comando a seguir:

• Para instâncias do Linux:

  cat $ECS_CONTAINER_METADATA_FILE

• Para instâncias do Windows (PowerShell):

  Get-Content -path $env:ECS_CONTAINER_METADATA_FILE