Atualizar o cluster anexado do EKS

A atualização de um cluster significa atualizar os atributos ou a versão associados aos clusters anexados ao GKE. Isso não altera a versão do Kubernetes que o cluster está em execução nem atualiza os atributos do cluster não relacionados aos clusters anexados ao GKE. É possível atualizar o cluster com o Google Cloud CLI ou o Console do Google Cloud.

CLI da gcloud

Para atualizar um cluster anexado, use o comando gcloud container attached clusters update:

gcloud container attached clusters update CLUSTER_NAME \
  --location GOOGLE_CLOUD_REGION

Substitua:

  • CLUSTER_NAME: o nome do cluster.
  • GOOGLE_CLOUD_REGION: o nome da região do Google Cloud para administrar o cluster

Para mais informações sobre todos os argumentos que podem ser usados ao atualizar um cluster, consulte comando gcloud container attached clusters update.

Console

  1. No console do Google Cloud, acesse a página Visão geral dos clusters do Google Kubernetes Engine.

    Acesse os clusters do GKE

  2. Selecione o projeto do Google Cloud em que o cluster está.

  3. Clique no nome do cluster que você quer atualizar e selecione Conferir mais detalhes no painel lateral.

  4. Na guia Detalhes, é possível atualizar informações básicas sobre o cluster ou fazer upgrade da versão dos clusters anexados ao GKE.

    • Para atualizar os fundamentos do cluster:

      1. Selecione Editar ao lado de um campo que você quer alterar.

      2. Quando terminar de fazer as mudanças, selecione Concluído.

    • Para fazer upgrade da versão dos clusters anexados ao GKE:

      1. Selecione Upgrade disponível ao lado de Versão da plataforma.

      2. Selecione a versão na lista e clique em Concluído.

    O upgrade da versão da plataforma não altera a versão do Kubernetes no cluster.

Use o argumento --platform-version para fazer upgrade do cluster

Use o argumento --platform-version opcional com o comando gcloud container attached clusters update para fazer upgrade da versão do software de clusters anexados do GKE instalado no cluster. Por exemplo, isso permite fazer upgrade da versão 1.28.0-gke.1 para 1.28.0-gke.3 ou da versão 1.28.x para 1.29.y

No entanto, não é possível usar o comando gcloud container attached clusters update para fazer upgrade de um cluster anexado usando a geração anterior dos clusters anexados do GKE para a geração atual. Esta geração anterior é um software mais antigo e não gerenciado que não recebe mais novos recursos, correções ou suporte.

Para migrar um cluster da geração anterior para a atual, siga as etapas em Migrar o cluster.

Numeração da versão da plataforma

Esses documentos se referem à versão dos clusters anexados ao GKE como a versão da plataforma, para diferenciá-la da versão do Kubernetes. Os clusters anexados ao GKE usam a mesma convenção de numeração de versões que o GKE. Por exemplo, 1.21.5-gke.1. Ao anexar ou atualizar seu cluster, escolha uma versão de plataforma em que a versão secundária seja igual ou um nível abaixo da versão do Kubernetes do cluster. Por exemplo, é possível anexar um cluster que executa o Kubernetes v1.22.* com a plataforma de clusters anexados do GKE 1.21.* ou 1.22.*.

Isso permite fazer upgrade do cluster para a próxima versão secundária antes de fazer upgrade dos clusters anexados ao GKE.