Skip to content

📖 Update CAPI support and guarantees for v1.12 #12934

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Nov 9, 2025
Merged

📖 Update CAPI support and guarantees for v1.12 #12934

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
2b9ac16
feat: Update book CAPI support and guarantee for v1.12
wendy-ha18 Nov 3, 2025
73d4ef3
fix: Update correct support timeline for v1.12, v1.11 and v1.10
wendy-ha18 Nov 9, 2025
0e64fe7
Update docs/book/src/reference/versions.md
wendy-ha18 Nov 9, 2025
b0e9ea0
Update docs/book/src/reference/versions.md
wendy-ha18 Nov 9, 2025
2ffcfd2
fix: Remove Kubernetes v1.26-v1.24 for clean and correct docs
wendy-ha18 Nov 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 16 additions & 18 deletions docs/book/src/reference/versions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,9 +67,10 @@ The table below documents support matrix for Cluster API versions (versions olde

| Minor Release | Status | Supported Until (including maintenance mode) |
|---------------|-------------------------|---------------------------------------------------------------------------------------------|
| v1.12.x | Standard support period | in maintenance mode when v1.14.0 will be released, EOL when v1.15.0 will be released |
| v1.11.x | Standard support period | in maintenance mode when v1.13.0 will be released, EOL when v1.14.0 will be released |
| v1.10.x | Standard support period | in maintenance mode when v1.12.0 will be released, EOL when v1.13.0 will be released |
| v1.9.x | Maintenance mode | Maintenance mode since 2025-08-12 - v1.11.0 release date, EOL when v1.12.0 will be released |
| v1.10.x | Maintenance mode | Maintenance mode since 2025-12-18 - v1.12.0 release date, EOL when v1.13.0 will be released |
| v1.9.x | EOL | EOL since 2025-12-18 - v1.12.0 release date |
| v1.8.x | EOL | EOL since 2025-08-12 - v1.11.0 release date |
| v1.7.x | EOL | EOL since 2025-04-22 - v1.10.0 release date |
| v1.6.x | EOL | EOL since 2024-12-10 - v1.9.0 release date |
Expand Down Expand Up @@ -270,19 +271,18 @@ In some cases, also Cluster API and/or Cluster API providers are defining additi
The following table defines the support matrix for the Cluster API core provider.
See [Cluster API release support](#cluster-api-release-support) and [Kubernetes versions support](#kubernetes-versions-support).

| | v1.9, _Maintenance Mode_ | v1.10 | v1.11 |
|------------------|--------------------------|-------------------|-------------------|
| Kubernetes v1.24 | | | |
| Kubernetes v1.25 | | | |
| Kubernetes v1.26 | ✓ (only workload) | | |
| Kubernetes v1.27 | ✓ (only workload) | ✓ (only workload) | |
| Kubernetes v1.28 | ✓ | ✓ (only workload) | ✓ (only workload) |
| Kubernetes v1.29 | ✓ | ✓ | ✓ (only workload) |
| Kubernetes v1.30 | ✓ | ✓ | ✓ |
| Kubernetes v1.31 | ✓ | ✓ | ✓ |
| Kubernetes v1.32 | ✓ >= v1.9.1 | ✓ | ✓ |
| Kubernetes v1.33 | | ✓ >= v1.10.1 | ✓ |
| Kubernetes v1.34 | | | ✓ >= v1.11.1 |
| |v1.10, _Maintenance Mode_ | v1.11 | v1.12 |
|------------------|--------------------------|-------------------|------------------------------|
| Kubernetes v1.27 | ✓ (only workload) | | |
| Kubernetes v1.28 | ✓ (only workload) | ✓ (only workload) | |
| Kubernetes v1.29 | ✓ | ✓ (only workload) | ✓ (only workload) |
| Kubernetes v1.30 | ✓ | ✓ | ✓ (only workload) |
| Kubernetes v1.31 | ✓ | ✓ | ✓ |
| Kubernetes v1.32 | ✓ | ✓ | ✓ |
| Kubernetes v1.33 | ✓ >= v1.10.1 | ✓ | ✓ |
| Kubernetes v1.34 | | ✓ >= v1.11.1 | ✓ |
| Kubernetes v1.35 | | | ✓ >= v1.12.1 |


See also [Kubernetes version specific notes](#kubernetes-version-specific-notes).

Expand All @@ -303,9 +303,6 @@ using the [kubeadm API](https://kubernetes.io/docs/setup/production-environment/

| | kubeadm API Version |
|------------------|------------------------------------------------------------------------------------|
| Kubernetes v1.24 | [v1beta3](https://kubernetes.io/docs/reference/config-api/kubeadm-config.v1beta3/) |
| Kubernetes v1.25 | [v1beta3](https://kubernetes.io/docs/reference/config-api/kubeadm-config.v1beta3/) |
| Kubernetes v1.26 | [v1beta3](https://kubernetes.io/docs/reference/config-api/kubeadm-config.v1beta3/) |
| Kubernetes v1.27 | [v1beta3](https://kubernetes.io/docs/reference/config-api/kubeadm-config.v1beta3/) |
| Kubernetes v1.28 | [v1beta3](https://kubernetes.io/docs/reference/config-api/kubeadm-config.v1beta3/) |
| Kubernetes v1.29 | [v1beta3](https://kubernetes.io/docs/reference/config-api/kubeadm-config.v1beta3/) |
Expand All @@ -314,6 +311,7 @@ using the [kubeadm API](https://kubernetes.io/docs/setup/production-environment/
| Kubernetes v1.32 | [v1beta4](https://kubernetes.io/docs/reference/config-api/kubeadm-config.v1beta4/) |
| Kubernetes v1.33 | [v1beta4](https://kubernetes.io/docs/reference/config-api/kubeadm-config.v1beta4/) |
| Kubernetes v1.34 | [v1beta4](https://kubernetes.io/docs/reference/config-api/kubeadm-config.v1beta4/) |
| Kubernetes v1.35 | [v1beta4](https://kubernetes.io/docs/reference/config-api/kubeadm-config.v1beta4/) |

### Kubeadm Control Plane provider (`kubeadm-control-plane-controller`)

Expand Down