Metadatos de tareas disponibles para tareas de Amazon ECS en EC2 - Amazon Elastic Container Service

Metadatos de tareas disponibles para tareas de Amazon ECS en EC2

El agente de contenedor de Amazon ECS proporciona un método para recuperar varios metadatos y estadísticas de Docker de tareas. Esto se conoce como el punto de enlace de metadatos de tarea. Están disponibles las siguientes versiones:

  • Versión 4 del punto de enlace de metadatos de tareas: proporciona diversos metadatos y estadísticas de Docker a los contenedores. También puede proporcionar datos de velocidad de red. Disponible para las tareas de Amazon ECS lanzadas en instancias Linux de Amazon EC2 que ejecutan la versión 1.39.0 del agente de contenedor de Amazon ECS como mínimo. Para instancias de Windows de Amazon EC2 que utilizan el modo de red awsvpc, el agente de contenedor de Amazon ECS debe ser versión 1.54.0 como mínimo. Para obtener más información, consulte Versión 4 del punto de conexión de metadatos de tareas de Amazon ECS.

  • Versión 3 del punto de enlace de metadatos de tareas: proporciona diversos metadatos y estadísticas de Docker a los contenedores. Disponible para las tareas de Amazon ECS lanzadas en instancias Linux de Amazon EC2 que ejecutan la versión 1.21.0 del agente de contenedor de Amazon ECS como mínimo. Para instancias de Windows de Amazon EC2 que utilizan el modo de red awsvpc, el agente de contenedor de Amazon ECS debe ser versión 1.54.0 como mínimo. Para obtener más información, consulte Versión 3 del punto de conexión de los metadatos de tareas de Amazon ECS.

  • Versión 2 del punto de enlace de metadatos de tareas: disponible para tareas de Amazon ECS lanzadas en instancias de Linux de Amazon EC2 que ejecutan la versión 1.17.0 del agente de contenedor de Amazon ECS como mínimo. Para instancias de Windows de Amazon EC2 que utilizan el modo de red awsvpc, el agente de contenedor de Amazon ECS debe ser versión 1.54.0 como mínimo. Para obtener más información, consulte Versión 2 del punto de conexión de los metadatos de tareas de Amazon ECS.

Si la tarea de Amazon ECS está alojada en Amazon EC2 o si la tarea utiliza el modo de red host y está alojada en Instancias administradas de Amazon ECS, también puede acceder a los metadatos del host de tareas mediante el punto de conexión del servicio de metadatos de instancias (IMDS). El siguiente comando, cuando se ejecuta desde la instancia que aloja la tarea, muestra el ID de la instancia del host. 

 curl http://169.254.169.254/latest/meta-data/instance-id

Si la tarea de Amazon ECS está alojada en Amazon EC2 y en una configuración de solo IPv6, puede acceder a los metadatos del host de tareas mediante el punto de conexión del IMDS de IPv6. El comando siguiente, cuando se pone en marcha desde la instancia que aloja la tarea, muestra el id. de la instancia del host a través de IPv6.

 curl http://[fd00:ec2::254]/latest/meta-data/instance-id

Para acceder al punto de conexión del IMDS de IPv6, habilite el punto de conexión del IMDS de IPv6 en la instancia de contenedor y configure también el modo de punto de conexión del servicio de metadatos mediante el proveedor de credenciales del IMDS para el SDK que elija a IPv6. Para obtener más información sobre cómo habilitar el punto de conexión del IMDS de IPv6 para la instancia de contenedor, consulte Configuración de las opciones del servicio de metadatos de instancias en la Guía del usuario de Amazon EC2. Para obtener más información sobre el proveedor de credenciales del IMDS para los SDK, consulte IMDS credential provider en la Guía de referencia de SDK y herramientas de AWS.

nota

No se puede acceder al punto de conexión del IMDS de IPv6 cuando la configuración de la cuenta de awsvpcTrunking está habilitada. Para acceder a las credenciales del rol de IAM de la instancia de contenedor cuando la configuración awsvpcTrunking está habilitada, puede utilizar un rol de IAM de tarea en su lugar. Para obtener más información acerca de los roles de IAM de tarea, consulte Rol de IAM de tarea de Amazon ECS.

La información que puede obtener desde el punto de conexión se divide en categorías como instance-id. Para obtener más información acerca de las diferentes categorías de metadatos de instancias de host que puede obtener mediante el punto de conexión, consulte Categorías de metadatos de instancias.