Metadados de tarefas disponíveis para tarefas do Amazon ECS no EC2 - Amazon Elastic Container Service

Metadados de tarefas disponíveis para tarefas do Amazon ECS no EC2

O agente de contêiner do Amazon ECS fornece um método para recuperar diversos metadados de tarefas e dados estatísticos do Docker. Isso é chamado de endpoint de metadados de tarefas. As seguintes versões estão disponíveis:

  • Endpoint de metadados de tarefas versão 4: fornece uma variedade de metadados e dados estatísticos do Docker para contêineres. Também pode fornecer dados de taxa de rede. Disponível para tarefas do Amazon ECS inicializadas em instâncias Linux do Amazon EC2 executando pelo menos a versão 1.39.0 do agente de contêiner do Amazon ECS. Para instâncias do Windows do Amazon EC2 que usam o modo de rede awsvpc, o agente de contêiner do Amazon ECS deve ter pelo menos a versão 1.54.0. Para obter mais informações, consulte Endpoint de metadados de tarefas do Amazon ECS versão 4.

  • Endpoint de metadados de tarefas versão 3: fornece uma variedade de metadados e dados estatísticos do Docker para contêineres. Disponível para tarefas do Amazon ECS inicializadas em instâncias Linux do Amazon EC2 executando pelo menos a versão 1.21.0 do agente de contêiner do Amazon ECS. Para instâncias do Windows do Amazon EC2 que usam o modo de rede awsvpc, o agente de contêiner do Amazon ECS deve ter pelo menos a versão 1.54.0. Para obter mais informações, consulte Endpoint de metadados de tarefas do Amazon ECS versão 3.

  • Endpoint de metadados de tarefas versão 2: disponível para tarefas do Amazon ECS inicializadas em instâncias Linux do Amazon EC2 executando pelo menos a versão 1.17.0 do agente de contêiner do Amazon ECS. Para instâncias do Windows do Amazon EC2 que usam o modo de rede awsvpc, o agente de contêiner do Amazon ECS deve ter pelo menos a versão 1.54.0. Para obter mais informações, consulte Endpoint de metadados de tarefas do Amazon ECS versão 2.

Se sua tarefa do Amazon ECS estiver hospedada no Amazon EC2 ou se ela usar o modo de rede host e estiver hospedada nas instâncias gerenciadas do Amazon ECS, você também poderá acessar os metadados do host de tarefas usando o endpoint do serviço de metadados de instância (IMDS). O comando a seguir, quando executado de dentro da instância que hospeda a tarefa, lista o ID da instância host. 

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

Se sua tarefa do Amazon ECS estiver hospedada no Amazon EC2 e em uma configuração somente IPv6, você poderá acessar os metadados do host de tarefas usando o endpoint IMDS IPv6. O comando a seguir, quando executado de dentro da instância que hospeda a tarefa, lista o ID da instância host sobre IPv6.

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

Para acessar o endpoint IMDS IPv6, habilite-o em sua instância de contêiner e também configure como IPv6 o modo de endpoint do serviço de metadados usando o provedor de credenciais IMDS do SDK escolhido. Para obter mais informações sobre como habilitar o endpoint IMDS IPv6 para sua instância de contêiner, consulte Configurar as opções do serviço de metadados de instância no Guia do usuário do Amazon EC2. Para obter mais informações sobre o provedor de credenciais IMDS para SDKs, consulte Provedor de credenciais IMDS no Guia de referência de SDKs e ferramentas da AWS.

nota

O endpoint IMDS IPv6 não está acessível quando a configuração da conta awsvpcTrunking está habilitada. Para acessar as credenciais do perfil do IAM da instância de contêiner quando awsvpcTrunking está habilitado, você pode usar um perfil do IAM de tarefa em vez disso. Para obter mais informações sobre perfis do IAM de tarefa, consulte Perfil do IAM para tarefas do Amazon ECS.

As informações que podem ser obtidas do endpoint são divididas em categorias, como instance-id. Para obter mais informações sobre as diferentes categorias de metadados da instância hospedeira que podem ser obtidas usando o endpoint, consulte Categorias de metadados da instância.