File di metadati del ECS contenitore Amazon

A partire dalla versione 1.15.0 di Amazon ECS Container Agent, sono disponibili diversi metadati del contenitore all'interno dei contenitori o dell'istanza del contenitore host. Attivando questa caratteristica, è possibile eseguire una query delle informazioni su un'attività, un container e un'istanza di container all'interno del container stesso o dell'istanza di container host. Il file di metadati viene creato sull'istanza host e montato nel contenitore come volume Docker e pertanto non è disponibile quando un'attività è ospitata su AWS Fargate.

Il file di metadati di container viene pulito sull'istanza host quando avviene lo stesso per il container. Puoi definire il momento in cui ciò accade tramite la variabile ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION dell'agente di container. Per ulteriori informazioni, consulta Pulizia automatica di ECS attività e immagini Amazon.

Argomenti

• Posizioni dei file di metadati dei container
• Attivazione dei metadati dei ECS container Amazon
• Formato di file di metadati del ECS contenitore Amazon

Posizioni dei file di metadati dei container

Di default, il file di metadati di container viene scritto sui percorsi di host e di container seguenti.

• Per le istanze Linux:

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

    Nota

    Il percorse dell'host di Linux presuppone che venga utilizzato il percorso di montaggio della directory dei dati predefinito (/var/lib/ecs/data) all'avvio dell'agente. Se non utilizzi un agente ECS ottimizzato per Amazon AMI (o il ecs-init pacchetto per avviare e gestire l'agente container), assicurati di impostare la variabile di configurazione dell'ECS_HOST_DATA_DIRagente sul percorso host in cui si trova il file di stato dell'agente del contenitore. Per ulteriori informazioni, consulta Configurazione di Amazon ECS Container Agent.

  • Percorso container: /opt/ecs/metadata/random_ID/ecs-container-metadata.json

• Per le istanze Windows:

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

  • Percorso container: C:\ProgramData\Amazon\ECS\metadata\random_ID\ecs-container-metadata.json

Tuttavia, per semplificare l'accesso, l'ubicazione del file di metadati di container è impostata sulla variabile di ambiente ECS_CONTAINER_METADATA_FILE all'interno del container. Puoi leggere il file contenuti dall'interno del container attraverso il comando seguente:

• Per le istanze Linux:

  cat $ECS_CONTAINER_METADATA_FILE

• Per le istanze Windows ()PowerShell:

  Get-Content -path $env:ECS_CONTAINER_METADATA_FILE