Atualizar o agente de contêiner do Amazon ECS - Serviço Amazon Elastic Container

Atualizar o agente de contêiner do Amazon ECS

Pode ser que, algumas vezes, você precise atualizar o agente de contêiner do Amazon ECS para obter as correções de erros e os 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

Você pode 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.

New AWS Management Console
  1. Abra o novo 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, você poderá atualizar seu agente de contêiner com os seguintes procedimentos:

    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 mais informações, consulte Iniciar uma instância de contêiner do Linux do Amazon ECS.

Classic AWS Management Console
  1. Abra o console do Amazon ECS em https://console.aws.amazon.com/ecs/.

  2. Na página Clusters, selecione o cluster que armazena a instância de contêiner ou as instâncias a serem verificadas.

  3. Na página Cluster: cluster_name, escolha ECS Instances.

  4. 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, você poderá atualizar seu agente de contêiner com os seguintes procedimentos:

    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 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 mais informações, consulte Introspecção do agente 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 | python -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.