Kubernetes Support Matrix
This document provides the Kubernetes version support matrix for . This information is critical when creating clusters, upgrading , and managing third-party clusters.
TOC
OverviewVersion Support MatrixACP 4.3 NotesThird-Party Cluster Management RangeUpgrade RequirementsOverview
supports multiple Kubernetes versions across different releases. Understanding the supported versions is essential for:
- Creating clusters – Determine which Kubernetes versions can be used when provisioning new clusters
- Upgrading – Ensure all workload clusters meet the documented compatible-version requirements before upgrading the global cluster
- Managing third-party clusters – Verify that public cloud or CNCF-compliant Kubernetes clusters are within the supported management range
Version Support Matrix
The following table shows the Kubernetes version support for each release.
The table lists minor versions and does not distinguish between patch versions. Patch versions only include bug fixes and security updates, so the Kubernetes minor versions remain consistent across all patch versions within the same minor release.
Starting from 4.1, each release supports only one Kubernetes version for cluster creation. This ensures consistency and simplifies the upgrade path for new clusters.
ACP 4.3 Notes
- ACP 4.3 adds support for Kubernetes 1.34 for platform-managed cluster scenarios.
- For upgrades to ACP 4.3, the workload-cluster compatible versions are 1.34, 1.33, 1.32, and 1.31.
- This means environments upgrading from ACP 4.0 to ACP 4.3 can keep workload clusters on Kubernetes 1.31 through 1.34 while upgrading the global cluster.
Third-Party Cluster Management Range
- For third-party clusters, ACP 4.3 accepts Kubernetes versions in the range
>=1.19.0 <1.35.0. - This management range is separate from the Compatible Versions column, which is the authoritative prerequisite for upgrading the ACP global cluster.
- Product documentation continues to list only the Kubernetes versions that have passed product validation for third-party cluster support and the default Extend baseline.
- Product validation for the Extend baseline covers the following capability areas:
- Installing and using Operators
- Installing and using Cluster Plugins
- ClickHouse-based logging
- VictoriaMetrics-based monitoring
- This does not mean that all specific Operators or Cluster Plugins are covered by product validation.
- For specific Operators or Cluster Plugins outside this baseline, refer to the relevant product documentation or contact technical support.
Upgrade Requirements
For 4.3 and later, workload clusters only need to remain within the documented compatible version range before upgrading the global cluster. For ACP 4.3, this means Kubernetes 1.31 through 1.34.
In 4.2 and earlier, all workload clusters must be upgraded to the latest Kubernetes version in the compatible versions list before upgrading the global cluster.