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.