Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 a Google Cloud CLI ou o console Google Cloud .
Selecione o Google Cloud projeto 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 edit 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 editUpgrade 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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-31 UTC."],[],[],null,["# Update your AKS attached cluster\n\nUpdating a cluster means updating the attributes or version associated with\nGKE attached clusters. This doesn't change the Kubernetes version that the cluster\nis running or update cluster attributes not related to GKE attached clusters. You can\nupdate the cluster with the Google Cloud CLI or the Google Cloud console. \n\n### gcloud CLI\n\nTo update an attached cluster, use the\n[`gcloud container attached clusters update` command](/sdk/gcloud/reference/container/attached/clusters/update):\n\n```sh\ngcloud container attached clusters update CLUSTER_NAME \\\n --location GOOGLE_CLOUD_REGION\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e: the name of the cluster\n- \u003cvar translate=\"no\"\u003eGOOGLE_CLOUD_REGION\u003c/var\u003e: the name of the Google Cloud region to administer your cluster from\n\nFor information about all the arguments you can use when updating a cluster,\nsee the\n[`gcloud container attached clusters update` command](/sdk/gcloud/reference/container/attached/clusters/update).\n\n### Console\n\n1. In the Google Cloud console, go to the **Google Kubernetes Engine clusters\n overview** page.\n\n [Go to GKE clusters](https://console.cloud.google.com/kubernetes/list/overview)\n2. Select the Google Cloud project that the cluster is in.\n\n3. Click the name of the cluster you want to update, and then select **View\n more details** in the side panel.\n\n4. On the **Details** tab, you can update basic information about the\n cluster or upgrade the GKE attached clusters version.\n\n - To update cluster basics:\n\n 1. Select edit **Edit** next to\n a field that you want to change.\n\n 2. When you are finished making changes, select **Done**.\n\n - To upgrade the GKE attached clusters version:\n\n 1. Select edit\n **Upgrade available** next to **Platform version**.\n\n 2. Select the version from the list, and click **Done**.\n\n Upgrading the platform version doesn't change the Kubernetes version\n on the cluster.\n\nUse the `--platform-version` argument to upgrade your cluster\n-------------------------------------------------------------\n\nUse the optional `--platform-version` argument with the\n`gcloud container attached clusters update` command to upgrade the\nversion of the GKE attached clusters software installed on your\ncluster. For example, this lets you upgrade from version 1.28.0-gke.1 to\n1.28.0-gke.3, or from version 1.28.x to 1.29.y.\n\nHowever, the `gcloud container attached clusters update` command can't be used\nto upgrade a cluster attached using the previous generation of\n[GKE attached clusters](/kubernetes-engine/multi-cloud/docs/attached/previous-generation/how-to/attach-kubernetes-clusters) to the current generation. This previous generation\nis older and unmanaged software that no longer receives new features, fixes, or\nsupport.\n\nTo migrate a cluster from the previous generation to the current generation,\nfollow the steps in\n[Migrate your cluster](/kubernetes-engine/multi-cloud/docs/attached/aks/how-to/migrate-cluster).\n\nPlatform version numbering\n--------------------------\n\nThese documents refer to the GKE attached clusters version as the platform version,\nto distinguish it from the Kubernetes version. GKE attached clusters uses the same\nversion numbering convention as GKE - for example, 1.21.5-gke.1. When attaching\nor updating your cluster, you must choose a platform version whose minor version\nis the same as or one level below the Kubernetes version of your cluster. For\nexample, you can attach a cluster running Kubernetes v1.22.\\* with\nGKE attached clusters platform version 1.21.\\* or 1.22.\\*.\n\nThis lets you upgrade your cluster to the next minor version before upgrading\nGKE attached clusters."]]
