Skip to content

Commit c45667b

Browse files
k8s-ci-robotk8s-ci-robot
authored
Merge pull request #8520 from furkatgofurov7/update-version-doc-k8s-1-27
📖 Update versions doc with k8s v1.27 notes
2 parents e774ad5 + af03bdd commit c45667b

File tree

1 file changed

+16
-10
lines changed

1 file changed

+16
-10
lines changed

‎docs/book/src/reference/versions.md

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -24,10 +24,10 @@ When a new Kubernetes minor release is available, we will try to support it in a
2424
the corresponding required changes in Cluster API are too invasive we won't backport the support and users have to wait
2525
for the next Cluster API minor release.
2626

27-
For example, Cluster API v1.4.0 would support the following Kubernetes versions:
28-
* v1.23.x to v1.26.x for the management cluster
29-
* v1.21.x to v1.26.x for the workload cluster
30-
* When Kubernetes 1.27 is released, it will be supported in v1.4.x (but not in v1.3.x)
27+
For example, Cluster API v1.5.0 would support the following Kubernetes versions:
28+
* v1.24.x to v1.27.x for the management cluster
29+
* v1.22.x to v1.27.x for the workload cluster
30+
* When Kubernetes 1.28 is released, it will be supported in v1.5.x (but not in v1.4.x)
3131

3232
Support in this context means that we:
3333
* maintain corresponding code paths
@@ -77,12 +77,13 @@ These diagrams show the relationships between components in a Cluster API releas
7777
| Kubernetes v1.18 | ✓ (only workload) | ✓ (only workload) | | |
7878
| Kubernetes v1.19 | ✓ (only workload) | ✓ (only workload) | | |
7979
| Kubernetes v1.20 | ✓ | ✓ | | |
80-
| Kubernetes v1.21 | ✓ | ✓ | ✓ (only workload) | ✓ (only workload) |
80+
| Kubernetes v1.21 | ✓ | ✓ | ✓ (only workload) | |
8181
| Kubernetes v1.22 | ✓ | ✓ | ✓ (only workload) | ✓ (only workload) |
82-
| Kubernetes v1.23* | ✓ | ✓ | ✓ | ✓ |
82+
| Kubernetes v1.23* | ✓ | ✓ | ✓ | ✓ (only workload) |
8383
| Kubernetes v1.24 | ✓ | ✓ | ✓ | ✓ |
8484
| Kubernetes v1.25 | ✓ | ✓ | ✓ | ✓ |
8585
| Kubernetes v1.26 | ✓ | ✓ | ✓ | ✓ |
86+
| Kubernetes v1.27 | | | ✓ | ✓ |
8687

8788

8889
\* There is an issue with CRDs in Kubernetes v1.23.{0-2}. ClusterClass with patches is affected by that (for more details please see [this issue](https://github.com/kubernetes-sigs/cluster-api/issues/5990)). Therefore we recommend to use Kubernetes v1.23.3+ with ClusterClass.
@@ -99,12 +100,13 @@ The Core Provider also talks to API server of every Workload Cluster. Therefore,
99100
| Kubernetes v1.18 + kubeadm/v1beta2 | ✓ (only workload) | ✓ (only workload) | | |
100101
| Kubernetes v1.19 + kubeadm/v1beta2 | ✓ (only workload) | ✓ (only workload) | | |
101102
| Kubernetes v1.20 + kubeadm/v1beta2 | ✓ | ✓ | | |
102-
| Kubernetes v1.21 + kubeadm/v1beta2 | ✓ | ✓ | ✓ (only workload) | ✓ (only workload) |
103+
| Kubernetes v1.21 + kubeadm/v1beta2 | ✓ | ✓ | ✓ (only workload) | |
103104
| Kubernetes v1.22 + kubeadm/v1beta3 | ✓ | ✓ | ✓ (only workload) | ✓ (only workload) |
104-
| Kubernetes v1.23 + kubeadm/v1beta3 | ✓ | ✓ | ✓ | ✓ |
105+
| Kubernetes v1.23 + kubeadm/v1beta3 | ✓ | ✓ | ✓ | ✓ (only workload) |
105106
| Kubernetes v1.24 + kubeadm/v1beta3 | ✓ | ✓ | ✓ | ✓ |
106107
| Kubernetes v1.25 + kubeadm/v1beta3 | ✓ | ✓ | ✓ | ✓ |
107108
| Kubernetes v1.26 + kubeadm/v1beta3 | ✓ | ✓ | ✓ | ✓ |
109+
| Kubernetes v1.27 + kubeadm/v1beta3 | | | ✓ | ✓ |
108110

109111
The Kubeadm Bootstrap Provider generates kubeadm configuration using the API version recommended for the target Kubernetes version.
110112

@@ -115,12 +117,13 @@ The Kubeadm Bootstrap Provider generates kubeadm configuration using the API ver
115117
| Kubernetes v1.18 + etcd/v3 | ✓ (only workload) | ✓ (only workload) | | |
116118
| Kubernetes v1.19 + etcd/v3 | ✓ (only workload) | ✓ (only workload) | | |
117119
| Kubernetes v1.20 + etcd/v3 | ✓ | ✓ | | |
118-
| Kubernetes v1.21 + etcd/v3 | ✓ | ✓ | ✓ (only workload) | ✓ (only workload) |
120+
| Kubernetes v1.21 + etcd/v3 | ✓ | ✓ | ✓ (only workload) | |
119121
| Kubernetes v1.22 + etcd/v3 | ✓ | ✓ | ✓ (only workload) | ✓ (only workload) |
120-
| Kubernetes v1.23 + etcd/v3 | ✓ | ✓ | ✓ | ✓ |
122+
| Kubernetes v1.23 + etcd/v3 | ✓ | ✓ | ✓ | ✓ (only workload) |
121123
| Kubernetes v1.24 + etcd/v3 | ✓ | ✓ | ✓ | ✓ |
122124
| Kubernetes v1.25 + etcd/v3 | ✓ | ✓ | ✓ | ✓ |
123125
| Kubernetes v1.26 + etcd/v3 | ✓ | ✓ | ✓ | ✓ |
126+
| Kubernetes v1.27 + etcd/v3 | | | ✓ | ✓ |
124127

125128
The Kubeadm Control Plane Provider talks to the API server and etcd members of every Workload Cluster whose control plane it owns. It uses the etcd v3 API.
126129

@@ -141,6 +144,9 @@ The Kubeadm Control Plane requires the Kubeadm Bootstrap Provider.
141144

142145
#### Kubernetes version specific notes
143146

147+
**1.27**:
148+
* No specific notes
149+
144150
**1.26**:
145151
* No specific notes
146152

0 commit comments

Comments
 (0)