Konvoy Documentation2.x represents a major movement forward in DKP architecture, incorporating ClusterAPI as a major re-architecture in its management of production Kubernetes clusters. ClusterAPI, or CAPI, enables declarative creation, configuration, and management of clusters. Declarative mode is a Kubernetes best practice that simplifies lifecycle tasks, making them more consistent and more repeatable.
Moving from Konvoy 1.8.x to DKP 2.1.x is not just an upgrade - you are enhancing your existing clusters to use a new architecture. If you currently use Konvoy to manage one cluster, that single-cluster experience continues in DKP 2.1.x, and includes the use of the management tools offered by Kommander. If you currently use Kommander to manage more than one cluster, your multi-cluster experience continues in DKP 2.1.x, with enhanced management and control offered by CAPI.
Upgrade paths
See the upgrade table in the DKP 2.3 documentation for the full upgrade paths supported.
Understanding the Major Version Upgrade Process
WARNING: D2iQ does NOT support the upgrade of 1.x clusters to 2.x when Kaptain is enabled. Disable Kaptain before upgrading your clusters to 2.x. Otherwise, your upgrade process might fail. For more information on using Kaptain on DKP 2.x, refer to Kaptain's fresh install documentation.
The overall process for upgrading the major version to DKP 2.1 has the following high-level steps:
-
Upgrade all clusters to Konvoy 1.8.3, Konvoy 1.8.4, or Konvoy 1.8.5
-
Review the CAPI concepts and terms, and understand the standard configuration
-
Perform the upgrade steps for your specific environment
For multi-cluster customers, the DKP major version upgrade is handled through the Konvoy clusters.
IMPORTANT: You must perform the major version upgrade steps on individual clusters, one at a time. No major version upgrade for multiple clusters managed by Kommander is available.
Understanding the Standard Configuration
Understanding the standard configuration as part of planning and preparing for your major version upgrade…Read More
Understanding CAPI Concepts and Terms
Some important CAPI terms and concepts you need for planning and preparing for your major version upgrade…Read More
Plan Your Upgrade
Planning for the preparation work, processes to complete, and changes before beginning the major version upgrade…Read More
Upgrade
Perform your major version upgrade…Read More
Migration Considerations for MetalLB
Some important considerations for MetalLB when when migrating from DKP 1.8.x to 2.1.x…Read More