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
No console do Google Cloud, acesse a página Visão geral dos clusters do Google Kubernetes Engine.
Selecione o projeto do Google Cloud em que o cluster está.
Clique no nome do cluster que você quer atualizar e selecione Conferir mais detalhes no painel lateral.
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:
Selecione
Editar ao lado de um campo que você quer alterar.Quando terminar de fazer as mudanças, selecione Concluído.
Para fazer upgrade da versão dos clusters anexados ao GKE:
Selecione
Upgrade disponível ao lado de Versão da plataforma.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.