Format de 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.

Format de fichier de métadonnées de conteneur Amazon ECS

Les informations suivantes sont stockées dans le fichier JSON de métadonnées de conteneur.

Cluster

Nom du cluster sur lequel le conteneur de la tâche est en cours d'exécution.

ContainerInstanceARN

Amazon Resource Name (ARN) de l'instance de conteneur hôte.

TaskARN

Amazon Resource Name (ARN) de la tâche à laquelle le conteneur appartient.

TaskDefinitionFamily

Nom de la famille de définitions de tâche utilisée par le conteneur.

TaskDefinitionRevision

Révision de définition de tâche utilisée par le conteneur.

ContainerID

ID de conteneur Docker (et non l'ID de conteneur Amazon ECS).

ContainerName

Nom de conteneur issu de la définition de tâche Amazon ECS.

DockerContainerName

Nom de conteneur que le démon Docker utilise pour le conteneur (par exemple, nom qui s'affiche dans la sortie de la commande docker ps).

ImageID

Résumé SHA de l'image Docker utilisée pour lancer le conteneur.

ImageName

Nom et balise de l'image Docker utilisée pour lancer le conteneur.

PortMappings

Mappages de port associés au conteneur.

ContainerPort

Port du conteneur qui est exposé.

HostPort

Port de l'instance de conteneur hôte qui est exposé.

BindIp

Adresse IP de liaison affectée au conteneur par Docker. Cette adresse IP est uniquement appliquée avec le mode réseau bridge. Elle est uniquement accessible à partir de l'instance de conteneur.

Protocol

Protocole réseau utilisé pour le mappage de port.

Networks

Mode réseau et adresse IP du conteneur.

NetworkMode

Mode réseau de la tâche à laquelle le conteneur appartient.

IPv4Addresses

Adresses IP associées au conteneur.

Important

Si votre tâche utilise le mode réseau awsvpc, l'adresse IP du conteneur n'est pas renvoyée. Dans ce cas, vous pouvez récupérer l'adresse IP en lisant le fichier /etc/hosts à l'aide de la commande suivante :

tail -1 /etc/hosts | awk '{print $1}'
MetadataFileStatus

Statut du fichier de métadonnées. Lorsque le statut est READY, le fichier de métadonnées est actuel et complet. Si le fichier n'est pas encore prêt (par exemple, au moment où la tâche est démarrée), une version tronquée du format de fichier est disponible. Pour éviter toute condition de concurrence où le conteneur démarrerait alors que les métadonnées ne sont pas encore écrites, vous pouvez analyser le fichier de métadonnées et attendre que ce paramètre passe à READY au préalable, selon les métadonnées. Cela est généralement disponible en moins de 1 seconde à partir du moment où le conteneur démarre.

AvailabilityZone

Zone de disponibilité dans laquelle réside l'instance de conteneur hôte.

HostPrivateIPv4Address

Adresse IP privée de la tâche à laquelle appartient le conteneur.

HostPublicIPv4Address

Adresse IP publique de la tâche à laquelle appartient le conteneur.

Exemple Fichier de métadonnées de conteneur Amazon ECS (READY)

L'exemple suivant montre un conteneur de fichiers de métadonnées avec le statut READY.

{
    "Cluster":"arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster",
    "TaskARN":"arn:aws:ecs:us-east-1:123456789012:task/MyCluster/b593651c4d6b44a6b2b583f45c957e15",
    "Family":"curltest-container",
    "Revision":"2",
    "DesiredStatus":"RUNNING",
    "KnownStatus":"RUNNING",
    "Limits":
        {
            "CPU":0.25,
            "Memory":512
        },
    "PullStartedAt":"2025-01-17T20:56:17.394610044Z",
    "PullStoppedAt":"2025-01-17T20:56:25.282708213Z",
    "AvailabilityZone":"us-east-1b",
    "LaunchType":"FARGATE",
    "Containers":[
        {
            "DockerId":"b593651c4d6b44a6b2b583f45c957e15-3356213583",
            "Name":"curltest","DockerName":"curltest",
            "Image":"public.ecr.aws/amazonlinux/amazonlinux:latest",
            "ImageID":"sha256:7f371357694782356b65c7fd60dd1ca124c47bd5ed1b1ffe7c0e17f562898367",
            "Labels":
                {
                    "com.amazonaws.ecs.cluster":"arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster",
                    "com.amazonaws.ecs.container-name":"curltest",
                    "com.amazonaws.ecs.task-arn":"arn:aws:ecs:us-east-1:123456789012:task/MyCluster/b593651c4d6b44a6b2b583f45c957e15",
                    "com.amazonaws.ecs.task-definition-family":"curltest-container","com.amazonaws.ecs.task-definition-version":"2"
               },
            "DesiredStatus":"RUNNING",
            "KnownStatus":"RUNNING",
            "Limits":
                {
                    "CPU":2
                },
            "CreatedAt":"2025-01-17T20:56:26.180347056Z",
            "StartedAt":"2025-01-17T20:56:26.180347056Z",
            "Type":"NORMAL",
            "LogDriver":"awslogs",
            "LogOptions":
                {
                    "awslogs-create-group":"true",
                    "awslogs-group":"/ecs/curltest-container",
                    "awslogs-region":"us-east-1",
                    "awslogs-stream":"ecs/curltest/b593651c4d6b44a6b2b583f45c957e15"
                       },
            "ContainerARN":"arn:aws:ecs:us-east-1:123456789012:container/MyCluster/b593651c4d6b44a6b2b583f45c957e15/934575e8-5bdb-478f-b763-2341a85b690e",
            "Networks":[
                {
                    "NetworkMode":"awsvpc",
                    "IPv4Addresses":["10.0.1.58"]
                }
            ],
            "Snapshotter":"overlayfs"
        }
    ],
    "ClockDrift":
        {
            "ClockErrorBound":0.487801,"ReferenceTimestamp":"2025-01-17T20:56:02Z",
            "ClockSynchronizationStatus":"SYNCHRONIZED"
        },
    "FaultInjectionEnabled":false
}
Exemple Fichier de métadonnées de conteneur Amazon ECS incomplet (pas encore READY)

L'exemple suivant montre un fichier de métadonnées de conteneur qui n'a pas encore atteint le statut READY. Les informations contenues dans le fichier sont limitées à quelques paramètres connus à partir de la définition de tâche. Le fichier de métadonnées de conteneur doit être prêt 1 seconde à compter du démarrage du conteneur.

{
    "Cluster": "default",
    "ContainerInstanceARN": "arn:aws:ecs:us-west-2:012345678910:container-instance/default/1f73d099-b914-411c-a9ff-81633b7741dd",
    "TaskARN": "arn:aws:ecs:us-west-2:012345678910:task/default/d90675f8-1a98-444b-805b-3d9cabb6fcd4",
    "ContainerName": "metadata"
}