Upgrade DKP
The DKP upgrade represents an important step of your environment’s lifecycle, as it ensures that you are up-to-date with the latest features and can benefit from the most recent improvements, enhanced cluster management, and better performance. This section describes how to upgrade your air-gapped and non-air-gapped environment to the latest version of DKP compatible with the latest Kubernetes version.
Prerequisite
Check what version of DKP you have downloaded currently using cli command dkp version.
dkp versionSupported Upgrade Paths
Use this table to determine your correct upgrade path:
Upgrading from Release… | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
…to Release | 2.4.0 | 2.4.1 | 2.5.0 | 2.5.1 | 2.5.2 | 2.6.0 | 2.6.1 | 2.6.2 | 2.7.0 | 2.7.1 | 2.7.2 | 2.7.3 | 2.8.0 | 2.8.1 | |
2.5.0 | Yes | Yes | NA | NA | NA | NA | NA | NA | NA | NA | NA | NA | NA | NA | |
2.5.1 | Yes | Yes | Yes | NA | NA | NA | NA | NA | NA | NA | NA | NA | NA | NA | |
2.5.2 | Yes | Yes | Yes | Yes | NA | NA | NA | NA | NA | NA | NA | NA | NA | NA | |
2.6.0 | No | No | Yes | Yes | Yes | NA | NA | NA | NA | NA | NA | NA | NA | NA | |
2.6.1 | No | No | Yes | Yes | Yes | Yes | NA | NA | NA | NA | NA | NA | NA | NA | |
2.6.2 | No | No | Yes | Yes | Yes | Yes | Yes | NA | NA | NA | NA | NA | NA | NA | |
2.7.0 | No | No | No | No | No | Yes | Yes | Yes | NA | NA | NA | NA | NA | NA | |
2.7.1 | No | No | No | No | No | Yes | Yes | Yes | Yes | NA | NA | NA | NA | NA | |
2.7.2 | No | No | No | No | No | Yes | Yes | Yes | Yes | Yes | NA | NA | NA | NA | |
2.7.3 | No | No | No | No | No | Yes | Yes | Yes | Yes | Yes | Yes | NA | NA | NA | |
2.8.0 | No | No | No | No | No | No | No | No | Yes | Yes | Yes | Yes | NA | NA | |
2.8.1 | No | No | No | No | No | No | No | No | Yes | Yes | Yes | Yes | Yes | NA | |
2.8.2 | No | No | No | No | No | No | No | No | Yes | Yes | Yes | Yes | Yes | Yes | |
Understand the Upgrade Process
For this release, you perform the upgrade sequentially, beginning with the DKP UI and then moving to upgrading clusters and CAPI components.
When upgrading DKP, the process is different depending on whether you run a stand-alone Management Cluster, or a multi-cluster environment that includes a combination of a Management cluster and managed or attached workspace clusters.
Start with your Management Cluster in the UI, and then, if more than one exists, proceed workspace by workspace until complete. You can then move to upgrading Konvoy, cluster by cluster.
The overall process for upgrading to the latest version of DKP is done on each Workspace or cluster, with the following processes:
Before upgrading, we strongly recommend reading the release notes and verifying your current setup against any possible breaking changes.
Review the list of major Kubernetes changes that may affect your system.
For Kommander, on your DKP Essential cluster or DKP Enterprise Management Cluster:
Upgrade the DKP UI and all Platform Applications.
If you do not have any managed or attached clusters, skip to upgrading Konvoy on your DKP Essential or DKP Management Cluster.
On your Workspaces (which include DKP Essential, DKP Enterprise Management Cluster and any Managed or Attached clusters):
Upgrade your Workspaces, which upgrades all Platform Applications on your workspace.
Upgrade all DKP Catalog applications deployed to Workspaces.
Upgrade all DKP Catalog applications deployed to Projects.
Verify any Custom Catalog applications and ensure they are compatible with the Kubernetes version included in the new release.
For Konvoy, on your DKP Essential cluster or DKP Enterprise Management Cluster:
Upgrade CAPI components (Essential or Enterprise section). This upgrades the CAPI controllers, which only run on the Management Cluster.
Upgrade the Core Addons (Essential or Enterprise section). This upgrades multiple addons such as CSI, CNI, Cluster Autoscaler, and Node Feature Discovery.
Upgrade the Kubernetes version (Essential or Enterprise section). This upgrades your cluster’s control plane and node pools.
If you do not have any managed or attached clusters, you have finished the upgrade process and can start testing your environment. If you have managed or attached clusters, continue with the next section.
For Konvoy, on your Managed Clusters:
Upgrade the Core Addons. This upgrades multiple addons such as CSI, CNI, Cluster Autoscaler, and Node Feature Discovery.
Upgrade the Kubernetes version. This upgrades your cluster’s control plane and node pools. We recommend you upgrade your Kubernetes version on any attached clusters.