Google Kubernetes Engine (GKE) upgrade guide

​

Prerequisites

• gcloud CLI installed.
• Kubectl installed.

export CLUSTER_PROJECT=<The project name of the cluster>
export CLUSTER_NAME=<The name of the cluster>
export CLUSTER_REGION=<The region where the cluster is located>

​

Get cluster credentials

1. If you aren’t already signed in with gcloud, run gcloud init.
2. To protect your current configuration file from being overwritten, run export KUBECONFIG=$(pwd)/kubeconfig.
3. Get the remote kubeconfig:
   gcloud container clusters get-credentials $CLUSTER_NAME --region $CLUSTER_REGION --project $CLUSTER_PROJECT
   

​

Disable the disruption budgets

1. Back up the PDBs:
   kubectl get pdb -n domino-platform -o yaml mongodb-arbiter > mongodb-arbiter.yml
   kubectl get pdb -n domino-platform -o yaml mongodb-primary > mongodb-primary.yml
   kubectl get pdb -n domino-platform -o yaml mongodb-secondary > mongodb-secondary.yml
   
2. Delete the PDBs:
   kubectl delete pdb -n domino-platform mongodb-arbiter
   kubectl delete pdb -n domino-platform mongodb-primary
   kubectl delete pdb -n domino-platform mongodb-secondary
   

​

Determine the upgrade version

1. Get the available GKE versions:
   gcloud container get-server-config \
     --region=${CLUSTER_REGION} \
     --flatten="channels" \
     --format="yaml(channels.channel,channels.validVersions)"
   
2. Get the current master version:
   gcloud container clusters describe ${CLUSTER_NAME} --region=${CLUSTER_REGION} --format="value(currentMasterVersion)"
   

​

Update the cluster

1. Upgrade the control plane. This might take several minutes to complete. Monitor the GCP console for the status of the cluster upgrade.
   gcloud container clusters upgrade $CLUSTER_NAME --project $CLUSTER_PROJECT --master --region $CLUSTER_REGION --cluster-version <version-number>
   
2. Upgrade the node pools:
   gcloud container clusters upgrade $CLUSTER_NAME --project $CLUSTER_PROJECT --region $CLUSTER_REGION --node-pool=platform
   gcloud container clusters upgrade $CLUSTER_NAME --project $CLUSTER_PROJECT --region $CLUSTER_REGION --node-pool=compute
   gcloud container clusters upgrade $CLUSTER_NAME --project $CLUSTER_PROJECT --region $CLUSTER_REGION --node-pool=gpu
   

​

Restore the disruption budgets

kubectl apply -f mongodb-arbiter.yml
kubectl apply -f mongodb-primary.yml
kubectl apply -f mongodb-secondary.yml