Atualize o cluster anexado em conformidade com a CNCF

A atualização de um cluster significa a atualização dos atributos ou da versão associada aos clusters anexados do GKE. Isto não altera a versão do Kubernetes em que o cluster está a ser executado nem atualiza os atributos do cluster não relacionados com clusters anexados do GKE. Pode atualizar o cluster com a CLI do Google Cloud ou a Google Cloud consola.

CLI 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 o seguinte:

  • CLUSTER_NAME: o nome do cluster
  • GOOGLE_CLOUD_REGION: o nome da Google Cloud região a partir da qual vai administrar o cluster

Para ver informações sobre todos os argumentos que pode usar ao atualizar um cluster, consulte o comando gcloud container attached clusters update.

Consola

  1. Na Google Cloud consola, aceda à página Vista geral dos clusters do Google Kubernetes Engine.

    Aceda aos clusters do GKE

  2. Selecione o Google Cloud projeto no qual o cluster se encontra.

  3. Clique no nome do cluster que quer atualizar e, de seguida, selecione Ver mais detalhes no painel lateral.

  4. No separador Detalhes, pode atualizar informações básicas sobre o cluster ou atualizar a versão dos clusters anexados do GKE.

    • Para atualizar os elementos básicos do cluster:

      1. Selecione Editar junto a um campo que quer alterar.

      2. Quando terminar as alterações, selecione Concluído.

    • Para atualizar a versão dos clusters anexados do GKE:

      1. Selecione Atualização disponível junto a Versão da plataforma.

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

    A atualização da versão da plataforma não altera a versão do Kubernetes no cluster.

Use o argumento --platform-version para atualizar o cluster

Use o argumento --platform-version opcional com o comando gcloud container attached clusters update para atualizar a versão do software de clusters anexados do GKE instalado no seu cluster. Por exemplo, isto permite-lhe atualizar 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 atualizar um cluster associado através da geração anterior de clusters associados do GKE para a geração atual. Esta geração anterior é um software mais antigo e não gerido que já não recebe novas funcionalidades, correções nem apoio técnico.

Para migrar um cluster da geração anterior para a geração atual, siga os passos descritos no artigo Migre o seu cluster.

Numeração das versões da plataforma

Estes documentos referem-se à versão dos clusters anexados do GKE como a versão da plataforma, para a distinguir da versão do Kubernetes. Os clusters anexados do GKE usam a mesma convenção de numeração de versões que o GKE, por exemplo, 1.21.5-gke.1. Quando anexar ou atualizar o cluster, tem de escolher uma versão da plataforma cuja versão secundária seja igual ou um nível inferior à versão do Kubernetes do cluster. Por exemplo, pode anexar um cluster que execute o Kubernetes v1.22.* com a versão 1.21.* ou 1.22.* da plataforma de clusters anexados do GKE.

Isto permite-lhe atualizar o cluster para a versão secundária seguinte antes de atualizar os clusters anexados do GKE.