Atualizar o cluster anexado em conformidade com a CNCF

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 Console

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.

  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.