Atualizar o agente de contêiner do Amazon ECS em uma AMI otimizada para Amazon ECS - Amazon Elastic Container Service
Atualizar o agente de contêiner do Amazon ECS com a operação de API do UpdateContainerAgent

Atualizar o agente de contêiner do Amazon ECS em uma AMI otimizada para Amazon ECS

Se você estiver usando a AMI otimizada para Amazon ECS, terá várias opções para obter a versão mais recente do agente de contêiner do Amazon ECS (mostrado por ordem de recomendação):

  • Encerre as instâncias de contêiner e inicie a versão mais recente da AMI do Amazon Linux 2 otimizada para Amazon ECS (manualmente ou atualizando a configuração de execução do Auto Scaling com a AMI mais recente). O resultado será uma instância de contêiner atualizada com as versões testadas e validadas mais recentes do Amazon Linux, do Docker, do ecs-init e do agente de contêiner do Amazon ECS. Para ter mais informações, consulte AMIs do Linux otimizadas para o Amazon ECS.

  • Conecte-se à instância com o SSH e atualize o pacote do ecs-init (e suas dependências) para a versão mais recente. Essa operação fornecerá as versões testadas e validadas mais recentes do Docker e do ecs-init que estão disponíveis nos repositórios do Amazon Linux e na versão mais recente do agente de contêiner do Amazon ECS. Para ter mais informações, consulte Para atualizar o pacote ecs-init em uma AMI otimizada para o Amazon ECS.

  • Atualize o agente de contêiner com a operação de API do UpdateContainerAgent, através do console ou com a AWS CLI ou os SDKs da AWS. Para ter mais informações, consulte Atualizar o agente de contêiner do Amazon ECS com a operação de API do UpdateContainerAgent.

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.

Para atualizar o pacote ecs-init em uma AMI otimizada para o Amazon ECS

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

  2. Atualize o pacote ecs-init com o comando a seguir.

    sudo yum update -y ecs-init
    nota

    O pacote ecs-init e o agente de contêiner do Amazon ECS são atualizados imediatamente. No entanto, as versões mais recentes do Docker não serão carregadas até que o daemon do Docker seja reiniciado. Inicie novamente reinicializando a instância ou executando os seguintes comandos em sua instância:

    • AMI do Amazon Linux 2 otimizada para Amazon ECS:

      sudo systemctl restart docker

    • AMI do Amazon Linux otimizada para Amazon ECS:

      sudo service docker restart && sudo start ecs

Atualizar o agente de contêiner do Amazon ECS com a operação de API do UpdateContainerAgent

Importante

A API do UpdateContainerAgent só é compatível com variantes Linux da AMI otimizada para o Amazon ECS, com exceção da AMI do Amazon Linux 2 (arm64) otimizada para Amazon ECS. Para instâncias de contêiner que usam a AMI do Amazon Linux 2 (arm64) otimizada para Amazon ECS, atualize o pacote ecs-init para atualizar o agente. Para instâncias de contêiner que estão executando outros sistemas operacionais, consulte Atualizar manualmente o agente de contêiner do Amazon ECS (para AMIs não otimizadas para Amazon ECS). Se você está usando instâncias de container do Windows. recomendamos que você inicie novas instâncias de contêiner para atualizar a versão do agente nos clusters do Windows.

O processo da API do UpdateContainerAgent começa quando você solicita uma atualização do agente, por meio do console ou com a AWS CLI ou AWS SDKs. O Amazon ECS compara a versão atual do agente com a versão mais recente disponível e verifica se é possível realizar uma atualização. Se uma atualização não estiver disponível, por exemplo, se o agente já estiver executando a versão mais recente, um NoUpdateAvailableException será retornado.

Os estágios do processo de atualização mostrados acima são os seguintes:

PENDING

Uma atualização de agente está disponível, e o processo de atualização iniciou.

STAGING

O agente começou a baixar a atualização do agente. Se o agente não conseguir baixar a atualização ou se o conteúdo da atualização estiver incorreto ou corrompido, o agente enviará uma notificação da falha, e a atualização passará para o estado FAILED.

STAGED

O download do agente foi concluído e o conteúdo do agente foi verificado.

UPDATING

O serviço ecs-init é reiniciado e obtém a nova versão do agente. Se, por algum motivo, não for possível reiniciar o agente, a atualização passará para o estado FAILED; do contrário, o agente informará ao Amazon ECS que a atualização foi concluída.

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.

Para atualizar o agente de contêiner do Amazon ECS em uma AMI otimizada para Amazon ECS no 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.

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

  5. Em Instâncias de contêiner, selecione as instâncias a serem atualizadas e escolha Ações, Agente de atualização.