Fichier de métadonnées de conteneur Amazon ECS - Amazon Elastic Container Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Fichier de métadonnées de conteneur Amazon ECS

À compter de la version 1.15.0 de l'agent conteneur Amazon ECS, diverses métadonnées de conteneur sont disponibles dans les conteneurs ou dans l'instance de conteneur hôte. En activant cette fonctionnalité, vous pouvez demander des informations sur une tâche, un conteneur ou une instance de conteneur depuis le conteneur ou l'instance de conteneur hôte. Le fichier de métadonnées est créé sur l'instance hôte et monté dans le conteneur en tant que volume Docker. Il n'est donc pas disponible lorsqu'une tâche est hébergée sur AWS Fargate.

Le fichier de métadonnées de conteneur est nettoyé sur l'instance de l'hôte lors du nettoyage du conteneur. Vous pouvez définir quand cette opération doit se produire avec la variable ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION de l'agent de conteneur. Pour de plus amples informations, veuillez consulter Nettoyage automatique des tâches et des images Amazon ECS.

Emplacements des fichiers de métadonnées de conteneur

Par défaut, le fichier de métadonnées de conteneur est écrit sur les chemins d'hôte et de conteneur suivants.

  • Pour les instances Linux :

    • Chemin hôte :/var/lib/ecs/data/metadata/cluster_name/task_id/container_name/ecs-container-metadata.json

      Note

      Le chemin hôte Linux suppose que le chemin de montage du répertoire de données par défaut (/var/lib/ecs/data) est utilisé lorsque l'agent est démarré. Si vous n'utilisez pas l'AMI optimisée pour Amazon ECS (ou le package ecs-init pour démarrer et gérer l'agent de conteneur), veillez à définir la variable de configuration de l'agent ECS_HOST_DATA_DIR sur le chemin hôte où se trouve le fichier d'état de l'agent de conteneur. Pour de plus amples informations, veuillez consulter Configuration de l'agent de conteneur Amazon ECS.

    • Chemin du conteneur : /opt/ecs/metadata/random_ID/ecs-container-metadata.json

  • Pour les instances Windows :

    • Chemin hôte :C:\ProgramData\Amazon\ECS\data\metadata\task_id\container_name\ecs-container-metadata.json

    • Chemin du conteneur : C:\ProgramData\Amazon\ECS\metadata\random_ID\ecs-container-metadata.json

Toutefois, pour en faciliter l'accès, l'emplacement du fichier de métadonnées de conteneur correspond à la variable d'environnement ECS_CONTAINER_METADATA_FILE à l'intérieur du conteneur. Vous pouvez lire le contenu du fichier depuis le conteneur via la commande suivante :

  • Pour les instances Linux :

    cat $ECS_CONTAINER_METADATA_FILE
  • Pour les instances Windows (PowerShell) :

    Get-Content -path $env:ECS_CONTAINER_METADATA_FILE