Updating and version management

The control plane update process in DKP is fully automated.

  • DKP supports the latest five Kubernetes versions.
  • You can roll back the control plane one minor version and upgrade forward several minor versions — one at a time.
  • Patch versions (e.g., 1.27.3 → 1.27.5) are updated automatically with Deckhouse and cannot be managed manually.
  • Minor versions are set manually using the kubernetesVersion parameter in the ClusterConfiguration resource.

Changing the Kubernetes version

  1. Open the ClusterConfiguration editor:

    d8 system edit cluster-configuration

  2. Set the target Kubernetes version using the kubernetesVersion field:

    apiVersion: deckhouse.io/v1
kind: ClusterConfiguration
cloud:
  prefix: demo-stand
  provider: Yandex
clusterDomain: cloud.education
clusterType: Cloud
defaultCRI: Containerd
kubernetesVersion: "1.30"
podSubnetCIDR: 10.111.0.0/16
podSubnetNodeCIDRPrefix: "24"
serviceSubnetCIDR: 10.222.0.0/16
  3. Save the changes.
  4. Wait for the update to complete. You can track the update progress with the d8 k get no command. The update can be considered complete when the updated version appears in the VERSION column of each cluster node in the command output.