Formato di file di metadati del contenitore Amazon ECS - Amazon Elastic Container Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Formato di file di metadati del contenitore Amazon ECS

Le informazioni seguenti vengono memorizzate nel file JSON di metadati del container.

Cluster

Il nome del cluster su cui viene eseguita l'attività di container.

ContainerInstanceARN

L'Amazon Resource Name (ARN) completo dell'istanza di container dell'host.

TaskARN

L'Amazon Resource Name (ARN) completo dell'attività a cui appartiene il container.

TaskDefinitionFamily

Il nome della famiglia di definizioni di processo utilizzata dal container.

TaskDefinitionRevision

La revisione della definizione di attività utilizzata dal container.

ContainerID

L'ID del container Docker (non si tratta dell'ID del container di Amazon ECS) per il container.

ContainerName

Il nome del container dalla definizione di attività di Amazon ECS per il container.

DockerContainerName

Il nome del container che il daemon Docker utilizza per il container (ad esempio, il nome che viene visualizzato nell'output del comando docker ps).

ImageID

Il digest SHA dell'immagine Docker utilizzato per avviare il container.

ImageName

Il nome e il tag dell'immagine Docker utilizzati per avviare il container.

PortMappings

Qualsiasi mappatura delle porte associate al container.

ContainerPort

La porta del container esposto.

HostPort

La porta dell'istanza di container host esposto.

BindIp

L'indirizzo IP di associazione assegnato al container da Docker. Questo indirizzo IP viene applicato solo con la modalità di rete bridge ed è accessibile solo dall'istanza di container.

Protocol

Il protocollo di rete utilizzato per la mappatura delle porte.

Networks

Le modalità di rete e l'indirizzo IP del container.

NetworkMode

Le modalità di rete dell'attività a cui appartiene il container.

IPv4Addresses

Gli indirizzi IP associati con il container.

Importante

Se l'attività utilizza la modalità di rete awsvpc, l'indirizzo IP del container non verrà restituito. In questo caso, puoi recuperare l'indirizzo IP leggendo il file /etc/hosts con il comando seguente:

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

Lo stato del file di metadati. Quando lo stato è READY, il file di metadati è corrente e completo. Se il file non è ancora pronto (ad esempio, nel momento in cui l'attività viene avviata), è disponibile una versione troncata del formato di file. Per evitare una probabile race condition in cui il container viene avviato, ma i metadati non sono ancora stati scritti, puoi analizzare il file di metadati e attendere che questo parametro sia impostato su READY prima di dipendere dai metadati. In genere, ciò è disponibile in meno di 1 secondo dall'avvio del container.

AvailabilityZone

Zona di disponibilità in cui risiede l'istanza di container host.

HostPrivateIPv4Address

L'indirizzo IP privato per l'attività a cui appartiene il container.

HostPublicIPv4Address

L'indirizzo IP pubblico per l'attività a cui appartiene il container.

Esempio File di metadati del container di Amazon ECS (READY)

L'esempio seguente mostra un file di metadati di container in stato 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
}
Esempio File di metadati di container Amazon ECS incompleto (non ancora READY)

L'esempio seguente mostra un file di metadati di container che non ha ancora raggiunto lo stato READY. Le informazioni incluse nel file sono limitate a pochi parametri noti dalla definizione di attività. In genere, il file di metadati di container è disponibile entro 1 secondo dopo l'avvio del container.

{
    "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"
}