Upgrade a non-advanced cluster and keep it as non-advanced

By default, a non-advanced cluster will be upgraded to an advanced cluster automatically when you upgrade to version 1.33. Although we recommend that you upgrade a non-advanced cluster to an advanced cluster, if you need to upgrade from 1.32 to 1.33 and keep the cluster as non-advanced, follow the steps in this document.

See the following for more information:

• For information on upgrading to version 1.32 and earlier, see Upgrade a cluster.

• For information on upgrading a non-advanced cluster to an advanced cluster, see Update or upgrade a cluster to an advanced cluster.

Prerequisites

• The gkectl version must be the same as the target cluster version.

  • If needed, see Download gkectl to get a supported version of gkectl.

• Always diagnose your cluster before updating or upgrading.

• Make sure your clusters use only recommended features.

• You must upgrade the admin cluster before you upgrade any user clusters.

Upgrade the admin cluster

1. Upgrade your admin workstation if needed.

2. Import OS images to vSphere:

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster=false
   

   Replace the following:

   • BUNDLE_PATH: the path of the bundle file. This file is on your admin workstation in /var/lib/gke/bundles/. For example:

     /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: the path of the admin cluster kubeconfig file.

3. Set enableAdvancedCluster in your admin cluster configuration file to false.

4. Make sure the bundlepath field in the admin cluster configuration file matches the path of the bundle to which you want to upgrade.

5. Upgrade the admin cluster and keep it as a non-advanced cluster:

   gkectl upgrade admin \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config ADMIN_CLUSTER_CONFIG
   

   Replace the following:

   • ADMIN_CLUSTER_KUBECONFIG: the path of the admin cluster kubeconfig file.
   • ADMIN_CLUSTER_CONFIG: the path of the admin cluster configuration file.

   The command will rollout recreate all the nodes in the admin cluster.

Upgrade the user cluster

Important: Make sure the admin cluster has already been upgraded.

1. Import OS images to vSphere:

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster=false
   

   Replace the following:

   • BUNDLE_PATH: the path of the bundle file. This file is on your admin workstation in /var/lib/gke/bundles/. For example:

     /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: the path of the admin cluster kubeconfig file.

2. Set enableAdvancedCluster in your user cluster configuration file to false.

3. Make sure the gkeOnPremVersion field in the user cluster configuration file matches the target version of your upgrade.

4. Upgrade the user cluster and keep it as a non-advanced cluster:

   gkectl upgrade cluster \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config USER_CLUSTER_CONFIG
   

   Replace the following:

   • ADMIN_CLUSTER_KUBECONFIG: the path of the admin cluster kubeconfig file.
   • USER_CLUSTER_CONFIG: the path of the user cluster configuration file.

   The command will recreate all the nodes in the user cluster.