Version and Lifecycle

Use this guidance to plan version compatibility, Kubernetes support, third-party cluster onboarding, runtime and OS boundaries, and Extension lifecycle checks.

Use Kubernetes Support Matrix for the exact Kubernetes version table.

Product And Kubernetes Versions

The Kubernetes support matrix separates three decisions: which Kubernetes targets can be used for platform-managed cluster creation, which workload-cluster versions satisfy the global cluster upgrade prerequisite, and which Kubernetes minors are product-supported for third-party cluster onboarding. Do not infer one range from another.

Before you upgrade the global cluster, every workload cluster created by must run a Kubernetes version within the Compatible Versions of the target release, and every cluster registered on the global cluster, including the components on imported and registered third-party clusters, must be within the direct upgrade window. See Upgrade Order and Compatibility.

Exact Kubernetes builds and creation targets come from versions offered by the installed platform patch and release-specific artifacts, not from this lifecycle overview.

For the exact table, see Kubernetes Support Matrix.

Third-Party Cluster Onboarding Range

Use Product-Tested Scope for Third-Party Clusters for the current product-supported Kubernetes range, the ongoing validation policy, and the default validation scope.

The product-tested onboarding range is shared by 4.3 and later releases that provide third-party cluster onboarding. It is maintained independently from the release-specific creation and Compatible Versions rows, and the shared range is updated when product validation expands.

This range is separate from:

  • The Kubernetes version supported for platform-managed cluster creation.
  • The Compatible Versions that workload clusters created by must run before you upgrade the global cluster.
  • Support for every provider, capability, operation, or Extension.

The published Kubernetes range establishes version eligibility. Follow Third-Party Cluster Onboarding and the selected Import, Register, or provider-specific procedure for connectivity, credentials, and environment-specific preparation.

For cluster model boundaries, see Cluster Management Models.

Runtime, OS, And CPU Architecture

Read runtime, OS, CRI, and CPU architecture information by responsibility boundary.

EnvironmentHow to read support information
lifecycle-managed environmentsThe platform installs and manages containerd. The exact runtime build follows the installed patch and is not a stable minor-release documentation value. For Alauda OS nodes, use the patch-specific OS Support Matrix.
Third-party clustersNode OS, container runtime, CRI, and CPU architecture usually remain the responsibility of the external cluster owner, external distribution, or cloud provider.
Alauda OS clustersUse the OS Support Matrix for Alauda OS images provided by , and Create on Alauda OS for provider-specific requirements.
ExtensionsUse the exact Extension documentation and Customer Portal compatibility metadata. Package availability for x86, ARM, or hybrid architectures is not a universal guarantee for every Extension image or provider scenario.

Do not infer complete Docker, CRI-O, Alauda OS, provider architecture, or universal Extension image support unless an explicit support matrix, Extension document, provider document, or release guidance states that support.

For non-Alauda OS node prerequisites, see Node Preprocessing. For package architecture, see Download. For Alauda OS clusters, see Create on Alauda OS.

Extension Lifecycle

Operators and Cluster Plugins use the Core, Aligned, and Agnostic lifecycle model.

LifecycleCompatibility and upgrade meaning
CoreFollows the Core release and the version (Distribution Version) of the cluster. Upgraded with the cluster.
AlignedFollows the release stream. When installed on a cluster, upgraded with the cluster; can also be upgraded on its own when a compatible version is published.
AgnosticReleased independently from . Not upgraded with the cluster; upgraded on its own when a compatible version is published.

For a specific Operator or Cluster Plugin version, use the Customer Portal ACP compatible versions field as the compatibility authority. Release notes are useful for version changes. The Kubernetes support matrix is not the authority for one exact Extension version.

For details, see Core and Extensions.

Feature Maturity

When reading Overview, release notes, or component documentation, treat maturity labels as support boundaries:

LabelMeaning for readers
GAThe feature is generally available within the documented scope and prerequisites.
Technology PreviewThe feature is available for evaluation within the documented limits and should not be treated as production-supported unless product documentation explicitly says so.
DeprecatedThe feature remains available but is planned for removal or replacement. Plan migration according to release guidance.
RemovedThe feature is no longer available in the documented release.

Global Cluster Disaster Recovery is generally available only within the documented global control-plane DR scope in Availability and Recovery.

Upgrade Reading Path

Before upgrading:

  1. Read Kubernetes Support Matrix to confirm the Compatible Versions for workload clusters.
  2. Read Upgrade Overview to understand what an upgrade changes, the upgrade order, and the risks.
  3. Read Prepare for the Upgrade before upgrading the global cluster.
  4. Review Release Notes for version changes, behavior changes, technical preview status, deprecated features, and known issues.