EMK - Kubernetes v1.31

Estimated time to read: 2 minutes

Upgrade to Kubernetes v1.32

All steps can be executed from the Cyso Cloud Dashboard or using the Kubernetes command line client kubectl.

Important

Always read through the Kubernetes changelog and upgrade notes before upgrading.

Breaking Changes in v1.32

OIDC Configuration: Migration Required

EMK no longer supports the traditional oidcConfig method in Kubernetes v1.32. If you are using oidcConfig in your Shoot specification, you must migrate to Structured Authentication before upgrading to v1.32.

Action required before upgrading:

1. Review your current Shoot specification for spec.kubernetes.kubeAPIServer.oidcConfig
2. Convert your oidcConfig to Structured Authentication format
3. Create a ConfigMap with your AuthenticationConfiguration
4. Update your Shoot specification to use spec.kubernetes.kubeAPIServer.structuredAuthentication
5. Trigger a cluster reconciliation to apply the changes

See the Structured authentication guide for detailed step-by-step instructions.

Upgrade Steps

1. Review the Kubernetes v1.32 changelog for all changes

2. Upgrade the cluster to Kubernetes v1.32:

   Using the Dashboard:

   • Navigate to your cluster in the Cyso Cloud dashboard
   • Click the '...' menu next to your cluster
   • Choose 'Upgrade Cluster'
   • Select version 1.32
   • Confirm the upgrade

   Using kubectl:

   kubectl patch shoot <cluster-name> --type merge -p '{"spec":{"kubernetes":{"version":"1.32.x"}}}'
   

3. Monitor the upgrade progress in the cluster overview

Upgrade Duration

The upgrade process can take several minutes depending on your cluster size. During this time, the cluster remains operational, but certain management operations may be temporarily unavailable.