Updating a cluster means updating the attributes or version associated with GKE attached clusters. This doesn't change the Kubernetes version that the cluster is running or update cluster attributes not related to GKE attached clusters. You can update the cluster with the Google Cloud CLI or the Google Cloud console.
gcloud CLI
To update an attached cluster, use the
gcloud container attached clusters update
command:
gcloud container attached clusters update CLUSTER_NAME \ --location GOOGLE_CLOUD_REGION
Replace the following:
CLUSTER_NAME
: the name of the clusterGOOGLE_CLOUD_REGION
: the name of the Google Cloud region to administer your cluster from
For information about all the arguments you can use when updating a cluster,
see the
gcloud container attached clusters update
command.
Console
In the Google Cloud console, go to the Google Kubernetes Engine clusters overview page.
Select the Google Cloud project that the cluster is in.
Click the name of the cluster you want to update, and then select View more details in the side panel.
On the Details tab, you can update basic information about the cluster or upgrade the GKE attached clusters version.
To update cluster basics:
Select
Edit next to a field that you want to change.When you are finished making changes, select Done.
To upgrade the GKE attached clusters version:
Select
Upgrade available next to Platform version.Select the version from the list, and click Done.
Upgrading the platform version doesn't change the Kubernetes version on the cluster.
Use the --platform-version
argument to upgrade your cluster
Use the optional --platform-version
argument with the
gcloud container attached clusters update
command to upgrade the
version of the GKE attached clusters software installed on your
cluster. For example, this lets you upgrade from version 1.28.0-gke.1 to
1.28.0-gke.3, or from version 1.28.x to 1.29.y.
However, the gcloud container attached clusters update
command can't be used
to upgrade a cluster attached using the previous generation of
GKE attached clusters to the current generation. This previous generation
is older and unmanaged software that no longer receives new features, fixes, or
support.
To migrate a cluster from the previous generation to the current generation, follow the steps in Migrate your cluster.
Platform version numbering
These documents refer to the GKE attached clusters version as the platform version, to distinguish it from the Kubernetes version. GKE attached clusters uses the same version numbering convention as GKE - for example, 1.21.5-gke.1. When attaching or updating your cluster, you must choose a platform version whose minor version is the same as or one level below the Kubernetes version of your cluster. For example, you can attach a cluster running Kubernetes v1.22.* with GKE attached clusters platform version 1.21.* or 1.22.*.
This lets you upgrade your cluster to the next minor version before upgrading GKE attached clusters.