Archivo de metadatos de contenedores de Amazon ECS - Amazon Elastic Container Service

Archivo de metadatos de contenedores de Amazon ECS

A partir de la versión 1.15.0 del agente de contenedor de Amazon ECS, hay varios metadatos disponibles en los contenedores o en la instancia de contenedor del host. Cuando se activa esta característica, puede consultar la información acerca de una tarea, un contenedor y una instancia de contenedor desde dentro del contenedor o de la instancia de contenedor del host. El archivo de metadatos se crea en la instancia de host y se monta en el contenedor como un volumen de Docker y, por lo tanto, no está disponible cuando una tarea está alojada en AWSFargate.

El archivo de metadatos del contenedor se limpia en la instancia de host al mismo tiempo que esta. Puede ajustar el momento en que esto sucede con la variable del agente de contenedor ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION. Para obtener más información, consulte Tareas automatizadas y limpieza de imágenes.

Ubicaciones de los archivos de metadatos de los contenedores

De forma predeterminada, el archivo de metadatos del contenedor se escribe en las rutas de host y contenedor siguientes.

  • En instancias de Linux:

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

      nota

      La ruta del host en Linux presupone que se utiliza la ruta de montaje del directorio de datos predeterminada (/var/lib/ecs/data) al iniciar el agente. Si no va a utilizar la AMI optimizada para Amazon ECS (o el paquete ecs-init para iniciar y mantener el agente de contenedor), asegúrese de establecer la variable de configuración del agente ECS_HOST_DATA_DIR en la ruta del host donde se encuentra el archivo de estado del agente de contenedor. Para obtener más información, consulte Configuración del agente de contenedor de Amazon ECS.

    • Ruta del contenedor: /opt/ecs/metadata/random_ID/ecs-container-metadata.json

  • En instancias de Windows:

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

    • Ruta del contenedor: C:\ProgramData\Amazon\ECS\metadata\random_ID\ecs-container-metadata.json

Sin embargo, para facilitar el acceso, la ubicación del archivo de metadatos del contenedor se establece en la variable de entorno ECS_CONTAINER_METADATA_FILE en el interior del contenedor. Puede leer el contenido del archivo desde dentro del contenedor con el siguiente comando:

  • En instancias de Linux:

    cat $ECS_CONTAINER_METADATA_FILE
  • En instancias de Windows (PowerShell):

    Get-Content -path $env:ECS_CONTAINER_METADATA_FILE