Upgrade a Cluster

This example shows how to upgrade a tenant cluster to a newer Kubernetes version.

Check Current Version

kubectl version --short

Consult your Qumulus administrator for supported Kubernetes versions.

Edit the cluster specification to update the version:

kubectl edit tenantcontrolplane my-cluster -n my-org

Change the version field:

spec:
  kubernetes:
    version: "1.29.0"  # Updated from 1.28.0

Watch the control plane components update:

kubectl get pods -n my-org -l kamaji.clastix.io/name=my-cluster -w

After the control plane upgrade completes, update the MachineDeployment:

kubectl edit machinedeployment my-cluster-workers -n my-org

Update the Kubernetes version in the template spec.

kubectl version --short
kubectl get nodes

All components should reflect the new version.

If issues occur, revert the version in the TenantControlPlane spec to the previous version.