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

For 4.3:

  • Platform-managed cluster creation supports Kubernetes 1.34.
  • Before upgrading the global cluster to 4.3, workload clusters must remain within the compatible versions 1.34, 1.33, 1.32, and 1.31.
  • For 4.3 and later, workload clusters only need to remain within the documented compatible-version range before a global cluster upgrade.
  • In 4.2 and earlier, workload clusters must be upgraded to the latest Kubernetes version in the compatible list before upgrading the global cluster.

For the exact table, see Kubernetes Support Matrix.

Third-Party Cluster Onboarding Range

For 4.3, third-party Kubernetes clusters are accepted for onboarding only in the range >=1.19.0 <1.35.0. Clusters outside that range are blocked from onboarding.

This range is separate from:

  • The Kubernetes version supported for platform-managed cluster creation.
  • The workload-cluster compatible versions used before upgrading the global cluster.
  • Product validation for every Kubernetes version, provider, capability, operation, or Extension.

Clusters in the accepted onboarding range still need to satisfy cluster-family or provider prerequisites, connectivity, credentials, installed components, provider caveats, and Extension compatibility.

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 environmentsUse the documented platform baseline and node prerequisite pages. For 4.3, the release notes identify containerd 2.0 as the platform runtime baseline.
HCP environmentsUse HCP-specific documentation and release notes. HCP runtime and version information is not replaced by a global platform runtime statement.
Third-party clustersNode OS, container runtime, CRI, and CPU architecture usually remain the responsibility of the external cluster owner, external distribution, or cloud provider.
Immutable InfrastructureUse the Immutable Infrastructure documentation for MicroOS images provided by and 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, MicroOS, mixed-architecture workload cluster, provider architecture, or universal Extension image support unless an explicit support matrix, Extension document, provider document, or release guidance states that support.

For node prerequisites, see Node Preprocessing. For package architecture, see Download. For Immutable Infrastructure, see About Immutable Infrastructure.

Extension Lifecycle

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

LifecycleCompatibility and upgrade meaning
CoreFollows the Core release and cluster Distribution Version. Updated through cluster upgrade.
AlignedFollows the release stream but can be upgraded independently when a compatible version is published.
AgnosticReleased independently from and upgraded independently 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.

For 4.3, HCP is Technology Preview and is not production-supported. 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 compatible workload-cluster versions.
  2. Read Upgrade Overview to understand the CVO-based upgrade model.
  3. Read Pre-Upgrade before upgrading the global cluster.
  4. Check Extension compatibility in the Customer Portal and the Extension documentation.
  5. Review Release Notes for version changes, behavior changes, technical preview status, deprecated features, and known issues.