Atualizar o agente de contêiner do Amazon ECS

Ocasionalmente, pode ser necessário atualizar o agente de contêiner do Amazon ECS para obter correções de erros e novos recursos. A atualização do agente de contêiner do Amazon ECS não interrompe a execução das tarefas ou dos serviços na instância de contêiner. O processo de atualização do agente varia, dependendo do local em que a instância de contêiner foi iniciada, se na AMI otimizada para Amazon ECS ou em outro sistema operacional.

nota

As atualizações de agente não se aplicam a instâncias de contêiner do Windows. É recomendável executar novas instâncias de contêiner para atualizar a versão do agente nos clusters do Windows.

Verificar a versão do agente de contêiner do Amazon ECS

É possível verificar a versão do agente de contêiner que está sendo executada nas instâncias de contêiner para saber se é preciso atualizá-la. A exibição da instância de contêiner no console do Amazon ECS fornece a versão do agente. Use o procedimento a seguir para verificar a versão do agente.

Amazon ECS console

1. Abra o console em https://console.aws.amazon.com/ecs/v2.

2. Na barra de navegação, escolha a região em que sua instância externa está registrada.

3. No painel de navegação, escolha Clusters e selecione o cluster que hospeda a instância externa.

4. Na página Cluster : name, escolha a guia Infrastructure (Infraestrutura).

5. Em Container instances (Instâncias de contêiner), observe a coluna Agent version (Versão do agente) para suas instâncias de contêiner. Se a instância de contêiner não contiver a versão mais recente do agente de contêiner, o console o alertará com uma mensagem e sinalizará a versão desatualizada do agente.

   Se a sua versão do agente estiver desatualizada, será possível atualizar seu agente de contêiner com os procedimentos a seguir:

   • Se sua instância de contêiner estiver executando a AMI otimizada para o Amazon ECS, consulte Atualizar o agente de contêiner do Amazon ECS em uma AMI otimizada para Amazon ECS.

   • Se sua instância de contêiner não estiver executando a AMI otimizada para o Amazon ECS, consulte Atualizar manualmente o agente de contêiner do Amazon ECS (para AMIs não otimizadas para Amazon ECS).

   Importante

   Para atualizar versões do agente do Amazon ECS anteriores à v1.0.0 na AMI otimizada para Amazon ECS, recomendamos que você encerre a instância de contêiner atual e execute uma nova instância com a versão mais recente da AMI. Todas as instâncias de contêiner que usam uma versão de pré-visualização devem ser retiradas e substituídas pela AMI mais recente. Para ter mais informações, consulte Iniciar uma instância de contêiner do Linux do Amazon ECS.

Amazon ECS container agent introspection API

Também é possível usar a API de introspecção do agente de contêiner do Amazon ECS para verificar a versão do agente na própria instância de contêiner. Para ter mais informações, consulte Introspecção de contêiner do Amazon ECS.

Para verificar se o agente de contêiner do Amazon ECS está executando a versão mais recente com a API de introspecção

1. Faça login em sua instância de contêiner via SSH.

2. Consulte a API de introspecção.

   [ec2-user ~]$ curl -s 127.0.0.1:51678/v1/metadata | python3 -mjson.tool

   nota

   A API de introspecção incluiu informações de Version na versão v1.0.0 do agente de contêiner do Amazon ECS. Se Version não estiver presente ao consultar a API de introspecção ou ela não estiver presente no seu agente, a versão que você está executando é v0.0.3 ou anterior. Você deve atualizar a versão.