Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Cluster Upgrade

Create the workload cluster with the source version:

export KUBERNETES_VERSION=v1.33.12
clusterctl generate cluster "${CLUSTER_NAME}" \
  --from templates/cluster-template.yaml \
  > "${CLUSTER_NAME}.yaml"
kubectl apply -f "${CLUSTER_NAME}.yaml"

Upgrade the control plane first:

kubectl patch kubeadmcontrolplane "${CLUSTER_NAME}-control-plane" \
  -n "${NAMESPACE}" \
  --type merge \
  -p '{"spec":{"version":"v1.34.8"}}'

Then upgrade the workers:

kubectl patch machinedeployment "${CLUSTER_NAME}-md-0" \
  -n "${NAMESPACE}" \
  --type merge \
  -p '{"spec":{"template":{"spec":{"version":"v1.34.8"}}}}'

Watch rollout state:

kubectl get kubeadmcontrolplane,machinedeployment,machineset,machine \
  -n "${NAMESPACE}" \
  -l "cluster.x-k8s.io/cluster-name=${CLUSTER_NAME}" \
  --watch

The current tested scope verifies MachineDeployment replacement behavior and VM cleanup. Full KubeadmControlPlane and Node readiness verification depends on completing workload-cluster bootstrap and cloud-provider integration.

See the root cluster-upgrade.md tutorial for the detailed step-by-step flow.