Dateiformat für Amazon ECS-Container-Metadaten

Die folgenden Informationen werden in der JSON-Datei mit den Container-Metadaten abgelegt.

Cluster

Der Name des Clusters, in dem die Aufgabe des Containers ausgeführt wird

ContainerInstanceARN

Der vollständige Amazon Resource Name (ARN) der Host-Container-Instance.

TaskARN

Der vollständige Amazon Resource Name (ARN) der Aufgabe, zu der der Container gehört.

TaskDefinitionFamily

Der Name der Aufgabendefinitionsfamilie, die der Container verwendet.

TaskDefinitionRevision

Die Aufgabendefinitionsrevision, die der Container verwendet.

ContainerID

Die Docker-Container-ID (und nicht die Amazon ECS Container-ID) für den Container.

ContainerName

Der Container-Name aus der Amazon-ECS-Aufgabendefinition für den Container.

DockerContainerName

Der Container-Name, den der Docker-Daemon für den Container verwendet (z. B. der Name, der in der Ausgabe des Befehls docker ps angezeigt wird)

ImageID

Der SHA-Digest für das Docker-Image zum Starten des Containers.

ImageName

Der Image-Name und das Tag für das Docker-Image zum Starten des Containers.

PortMappings

Alle Port-Zuordnungen für den Container.

ContainerPort

Der Port, auf dem der Container offengelegt ist.

HostPort

Der Port, auf der Host-Container-Instance, der offengelegt ist.

BindIp

Die Binde-IP-Adresse, die dem Container von Docker zugewiesen wurde. Diese IP-Adresse wird nur mit dem Netzwerkmodus bridge angewendet und steht nur über die Container-Instance zur Verfügung.

Protocol

Das für die Port-Zuweisung verwendete Netzwerkprotokoll.

Networks

Der Netzwerk-Modus und die IP-Adresse für den Container.

NetworkMode

Der Netzwerk-Modus für die Aufgabe, zu der der Container gehört.

IPv4Addresses

Die IP-Adressen, die mit dem Container verknüpft sind.

Wichtig

Wenn Ihre Aufgabe den Netzwerkmodus awsvpc verwendet, wird die IP-Adresse des Containers nicht zurückgegeben. In diesem Fall können Sie die IP-Adresse abrufen, indem Sie die Datei /etc/hosts mit dem folgenden Befehl auslesen:

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

MetadataFileStatus

Der Status der Metadatendatei. Wenn der Status READY ist, ist die Metadatendatei aktuell und vollständig. Wenn die Datei noch nicht bereit ist (z. B. in dem Moment, in dem die Aufgabe gestartet wird), steht eine gekürzte Version des Dateiformats zur Verfügung. Um eine Wettlaufsituation zu vermeiden, wenn der Container gestartet wurde, die Metadaten aber noch nicht geschrieben wurden, können Sie die Metadatendatei analysieren und warten, bis dieser Parameter auf READY gesetzt wurde, bevor Sie die Metadaten verwenden. Diese stehen in der Regel in weniger als 1 Sekunde zur Verfügung, nachdem der Container gestartet wurde.

AvailabilityZone

Die Availability Zone, in der sich die Host-Container-Instance befindet.

HostPrivateIPv4Address

Die private IP-Adresse der Aufgabe, zu der der Container gehört.

HostPublicIPv4Address

Die öffentliche IP-Adresse der Aufgabe, zu der der Container gehört.

Beispiel Amazon ECS Container-Metadatendatei (READY)

Das folgende Beispiel zeigt eine Container-Metadatendatei im Status READY.

{
    "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/2b88376d-aba3-4950-9ddf-bcb0f388a40c",
    "TaskDefinitionFamily": "console-sample-app-static",
    "TaskDefinitionRevision": "1",
    "ContainerID": "aec2557997f4eed9b280c2efd7afccdcedfda4ac399f7480cae870cfc7e163fd",
    "ContainerName": "simple-app",
    "CreatedAt": "2023-10-08T20:09:11.44527186Z",
    "StartedAt": "2023-10-08T20:09:11.44527186Z",
    "DockerContainerName": "/ecs-console-sample-app-static-1-simple-app-e4e8e495e8baa5de1a00",
    "ImageID": "sha256:2ae34abc2ed0a22e280d17e13f9c01aaf725688b09b7a1525d1a2750e2c0d1de",
    "ImageName": "httpd:2.4",
    "PortMappings": [
        {
            "ContainerPort": 80,
            "HostPort": 80,
            "BindIp": "0.0.0.0",
            "Protocol": "tcp"
        }
    ],
    "Networks": [
        {
            "NetworkMode": "bridge",
            "IPv4Addresses": ["192.0.2.0"]
        }
    ],
    "MetadataFileStatus": "READY",
    "AvailabilityZone": "us-east-1b",
    "HostPrivateIPv4Address": "192.0.2.0",
    "HostPublicIPv4Address": "203.0.113.0"
}

Beispiel Unvollständige Amazon ECS Container-Metadatendatei (noch nicht READY)

Das folgende Beispiel zeigt eine Container-Metadatendatei, die den Status READY noch nicht erreicht hat. Die Informationen in der Datei sind auf ein paar wenige Parameter beschränkt, die aus der Aufgabendefinition bekannt sind. Die Container-Metadatendatei sollte innerhalb von 1 Sekunde nach dem Starten des Containers zur Verfügung stehen.

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