Update your AKS attached cluster

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 cluster
  • GOOGLE_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

  1. In the Google Cloud console, go to the Google Kubernetes Engine clusters overview page.

    Go to GKE clusters

  2. Select the Google Cloud project that the cluster is in.

  3. Click the name of the cluster you want to update, and then select View more details in the side panel.

  4. On the Details tab, you can update basic information about the cluster or upgrade the GKE attached clusters version.

    • To update cluster basics:

      1. Select Edit next to a field that you want to change.

      2. When you are finished making changes, select Done.

    • To upgrade the GKE attached clusters version:

      1. Select Upgrade available next to Platform version.

      2. 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.