Skip to content

Commit 199c78b

Browse files
SgtCoDFishSgtCoDFish
committed
update supported releases page
1. Add abbr tags to define abbreviations 2. Update k8s versions for cloud vendors 3. Treat OpenShift EUS as a separate vendor 4. Move "old releases" to the bottom of the page 5. Update supported versions for current releases to include k8s 1.31 Signed-off-by: Ashley Davis <ashley.davis@venafi.com>
1 parent f8833a3 commit 199c78b

File tree

1 file changed

+78
-69
lines changed

1 file changed

+78
-69
lines changed

‎content/docs/releases/README.md‎

Lines changed: 78 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -25,69 +25,20 @@ should be stable enough to run.
2525

2626
| Release | Release Date | End of Life | [Supported Kubernetes versions][s] | [Supported OpenShift versions][s] |
2727
|--------------|:------------:|:----------------------:|:----------------------------------:|:---------------------------------:|
28-
| [1.15][] | Jun 05, 2024 | Release of 1.17 | 1.24 → 1.30 | 4.11 → 4.15 |
29-
| [1.14][] | Feb 03, 2024 | Release of 1.16 | 1.24 → 1.30 | 4.11 → 4.15 |
30-
| [1.12 LTS][] | May 19, 2023 | May 19, 2025 | 1.22 → 1.30 | 4.9 → 4.15 |
28+
| [1.15][] | Jun 05, 2024 | Release of 1.17 | 1.25 → 1.31 | 4.12 → 4.16 |
29+
| [1.14][] | Feb 03, 2024 | Release of 1.16 | 1.24 → 1.31 | 4.11 → 4.16 |
30+
| [1.12 LTS][] | May 19, 2023 | May 19, 2025 | 1.22 → 1.31 | 4.9 → 4.16 |
3131

3232
cert-manager 1.12 is a Long Term Support (LTS) release sponsored by [Venafi](https://www.venafi.com/). It will continue to be supported for at least 2 years from release.
3333

3434
## Upcoming releases
3535

3636
| Release | Release Date | End of Life | [Supported Kubernetes versions][s] | [Supported OpenShift versions][s] |
3737
|----------|:------------:|:----------------:|:----------------------------------:|:---------------------------------:|
38-
| [1.16][] | Oct 03, 2024 | Release of 1.18 | 1.25 → 1.30 | 4.12 → 4.15 |
38+
| [1.16][] | Oct 03, 2024 | Release of 1.18 | 1.27 → 1.31 | 4.14 → 4.16 |
3939

4040
Dates in the future are not firm commitments and are subject to change.
4141

42-
## Old releases
43-
44-
| Release | Release Date | EOL | Compatible Kubernetes versions | Compatible OpenShift versions |
45-
|----------|:------------:|:------------:|:------------------------------:|:-----------------------------:|
46-
| [1.13][] | Sep 12, 2023 | Jun 05, 2024 | 1.21 → 1.27 | 4.8 → 4.14 |
47-
| [1.11][] | Jan 11, 2023 | Sep 12, 2023 | 1.21 → 1.27 | 4.8 → 4.14 |
48-
| [1.10][] | Oct 17, 2022 | May 19, 2023 | 1.20 → 1.26 | 4.7 → 4.13 |
49-
| [1.9][] | Jul 22, 2022 | Jan 11, 2023 | 1.20 → 1.24 | 4.7 → 4.11 |
50-
| [1.8][] | Apr 05, 2022 | Oct 17, 2022 | 1.19 → 1.24 | 4.6 → 4.11 |
51-
| [1.7][] | Jan 26, 2021 | Jul 22, 2022 | 1.18 → 1.23 | 4.5 → 4.9 |
52-
| [1.6][] | Oct 26, 2021 | Apr 05, 2022 | 1.17 → 1.22 | 4.4 → 4.9 |
53-
| [1.5][] | Aug 11, 2021 | Jan 26, 2022 | 1.16 → 1.22 | 4.3 → 4.8 |
54-
| [1.4][] | Jun 15, 2021 | Oct 26, 2021 | 1.16 → 1.21 | 4.3 → 4.7 |
55-
| [1.3][] | Apr 08, 2021 | Aug 11, 2021 | 1.16 → 1.21 | 4.3 → 4.7 |
56-
| [1.2][] | Feb 10, 2021 | Jun 15, 2021 | 1.16 → 1.21 | 4.3 → 4.7 |
57-
| [1.1][] | Nov 24, 2020 | Apr 08, 2021 | 1.11 → 1.21 | 3.11 → 4.7 |
58-
| [1.0][] | Sep 02, 2020 | Feb 10, 2021 | 1.11 → 1.21 | 3.11 → 4.7 |
59-
| [0.16][] | Jul 23, 2020 | Nov 24, 2020 | 1.11 → 1.21 | 3.11 → 4.7 |
60-
| [0.15][] | May 06, 2020 | Sep 02, 2020 | 1.11 → 1.21 | 3.11 → 4.7 |
61-
| [0.14][] | Mar 11, 2020 | Jul 23, 2020 | 1.11 → 1.21 | 3.11 → 4.7 |
62-
| [0.13][] | Jan 21, 2020 | May 06, 2020 | 1.11 → 1.21 | 3.11 → 4.7 |
63-
| [0.12][] | Nov 27, 2019 | Mar 11, 2020 | 1.11 → 1.21 | 3.11 → 4.7 |
64-
| [0.11][] | Oct 10, 2019 | Jan 21, 2020 | 1.9 → 1.21 | 3.09 → 4.7 |
65-
66-
[s]: #kubernetes-supported-versions
67-
[1.16]: https://github.com/cert-manager/cert-manager/milestone/38
68-
[1.15]: ./release-notes/release-notes-1.15.md
69-
[1.14]: ./release-notes/release-notes-1.14.md
70-
[1.13]: ./release-notes/release-notes-1.13.md
71-
[1.12 LTS]: ./release-notes/release-notes-1.12.md
72-
[1.11]: ./release-notes/release-notes-1.11.md
73-
[1.10]: ./release-notes/release-notes-1.10.md
74-
[1.9]: ./release-notes/release-notes-1.9.md
75-
[1.8]: ./release-notes/release-notes-1.8.md
76-
[1.7]: ./release-notes/release-notes-1.7.md
77-
[1.6]: ./release-notes/release-notes-1.6.md
78-
[1.5]: ./release-notes/release-notes-1.5.md
79-
[1.4]: ./release-notes/release-notes-1.4.md
80-
[1.3]: ./release-notes/release-notes-1.3.md
81-
[1.2]: ./release-notes/release-notes-1.2.md
82-
[1.1]: ./release-notes/release-notes-1.1.md
83-
[1.0]: ./release-notes/release-notes-1.0.md
84-
[0.16]: ./release-notes/release-notes-0.16.md
85-
[0.15]: ./release-notes/release-notes-0.15.md
86-
[0.14]: ./release-notes/release-notes-0.14.md
87-
[0.13]: ./release-notes/release-notes-0.13.md
88-
[0.12]: ./release-notes/release-notes-0.12.md
89-
[0.11]: ./release-notes/release-notes-0.11.md
90-
9142
We list cert-manager releases on [GitHub](https://github.com/cert-manager/cert-manager/releases),
9243
and release notes on [cert-manager.io](https://cert-manager.io/docs/release-notes/).
9344

@@ -230,16 +181,24 @@ depends on what the cert-manager maintainers think is reasonable to support and
230181

231182
In practice, this is largely determined based on what versions of [kind](https://github.com/kubernetes-sigs/kind)
232183
are available for testing, and which versions of Kubernetes are provided by major upstream cloud Kubernetes vendors
233-
including EKS, GKE, AKS and OpenShift.
184+
including <abbr title="Amazon Elastic Kubernetes Service">EKS</abbr>, <abbr title="Google Kubernetes Engine">GKE</abbr>, <abbr title="Azure Kubernetes Service">AKS</abbr> and OpenShift.
185+
186+
We treat OpenShift <abbr title="Extended Update Support">EUS</abbr> as a different distribution since the support periods are so much longer.
187+
We're likely to drop support for older OpenShift EUS before that release reaches EOL to increase the speed at which we can adopt
188+
newer Kubernetes features.
189+
190+
The table below lists the major Kubernetes distributions we check. In brackets next to each release is the <abbr title="End-of-life">EOL</abbr>
191+
for that release. EOL dates often change throughout the lifecycle of a release.
234192

235-
| Vendor | Oldest Kubernetes Release\* | Other Kubernetes Releases |
236-
|:-----------------:|-----------------------------|------------------------------------------------------------------------------------|
237-
| [EKS][eks] | 1.25 (EOL May 2024) | 1.26 (EOL Jun 2024), 1.27 (EOL Jul 2024), 1.28 (EOL Nov 2024), 1.29 (EOL Mar 2025) |
238-
| [GKE][gke] | 1.26 (EOL May 2024) | 1.27 (EOL Aug 2024), 1.28 (EOL Sep 2024), 1.29 (EOL Jan 2025) |
239-
| [AKS][aks] | 1.26 (EOL Jun 2024) | 1.27 (EOL Jul 2024), 1.28 (EOL Nov 2024), 1.29 (EOL - ) |
240-
| [OpenShift 4][os] | 1.25 (4.12, EOL Jul 2024) | 1.26 (4.13, EOL Nov 2024), 1.27 (4.14, EOL May 2025), 1.28 (4.15, EOL Aug 2025) |
193+
The "Oldest Kubernetes Release" is the oldest release we deemed relevant to the next cert-manager release, as of 2024-09-25
241194

242-
\*Oldest release relevant to the next cert-manager release, as of 2024-04-19
195+
| Vendor | Oldest K8s Release | Other Kubernetes Releases |
196+
|:---------------------:|:---------------------:|----------------------------------------------------------------------|
197+
| [EKS][eks] | 1.28 (Nov 2024) | 1.29 (Mar 2025), 1.30 (Jul 2025) |
198+
| [GKE][gke] | 1.28 (Feb 2025) | 1.29 (Mar 2025), 1.30 (Sep 2025) |
199+
| [AKS][aks] | 1.28 (Jan 2025) | 1.29 (Mar 2025), 1.30 (Jul 2025), 1.31 (Nov 2025) |
200+
| [OpenShift 4][os] | 1.26 (4.13, Nov 2024) | 1.27 (4.14, May 2025), 1.28 (4.15, Aug 2025), 1.29 (4.16, Dec 2025) |
201+
| [OpenShift 4 EUS][os] | 1.25 (4.12, Jan 2025) | 1.27 (4.14, Oct 2025), 1.29 (4.16, Jun 2026) |
243202

244203
[eks]: https://endoflife.date/amazon-eks
245204
[gke]: https://endoflife.date/google-kubernetes-engine
@@ -248,23 +207,21 @@ including EKS, GKE, AKS and OpenShift.
248207

249208
### OpenShift
250209

251-
cert-manager supports versions of OpenShift 4 based on the version of Kubernetes
252-
that each version maps to.
210+
cert-manager supports OpenShift 4 based on the version of Kubernetes
211+
that each release maps to.
253212

254213
For convenience, the following table shows these version mappings:
255214

256215
| OpenShift versions | Kubernetes version |
257-
|--------------------|--------------------|
216+
|:------------------:|--------------------|
217+
| 4.16, 4.16 EUS | 1.29 |
258218
| 4.15 | 1.28 |
259-
| 4.14 | 1.27 |
219+
| 4.14, 4.14 EUS | 1.27 |
260220
| 4.13 | 1.26 |
261-
| 4.12 | 1.25 |
221+
| 4.12, 4.12 EUS | 1.25 |
262222
| 4.11 | 1.24 |
263223
| 4.10, 4.10 EUS | 1.23 |
264224
| 4.9 | 1.22 |
265-
| 4.8, 4.8 EUS | 1.21 |
266-
| 4.7 | 1.20 |
267-
| 4.6, 4.6 EUS | 1.19 |
268225

269226
Note that some OpenShift versions listed above may be predicted, since an updated version of OpenShift may
270227
not yet be available for the latest Kubernetes releases.
@@ -308,3 +265,55 @@ v<major>.<minor>.<patch>
308265
where `<minor>` is increased for each release, and `<patch>` counts the
309266
number of patches for the current `<minor>` release. A patch is usually a
310267
small change relative to the `<minor>` release.
268+
269+
## Old cert-manager releases
270+
271+
These cert-manager releases have reached their <abbr title="end-of-life">EOL</abbr> date and
272+
are no longer supported.
273+
274+
| Release | Release Date | EOL | Compatible Kubernetes versions | Compatible OpenShift versions |
275+
|----------|:------------:|:------------:|:------------------------------:|:-----------------------------:|
276+
| [1.13][] | Sep 12, 2023 | Jun 05, 2024 | 1.21 → 1.27 | 4.8 → 4.14 |
277+
| [1.11][] | Jan 11, 2023 | Sep 12, 2023 | 1.21 → 1.27 | 4.8 → 4.14 |
278+
| [1.10][] | Oct 17, 2022 | May 19, 2023 | 1.20 → 1.26 | 4.7 → 4.13 |
279+
| [1.9][] | Jul 22, 2022 | Jan 11, 2023 | 1.20 → 1.24 | 4.7 → 4.11 |
280+
| [1.8][] | Apr 05, 2022 | Oct 17, 2022 | 1.19 → 1.24 | 4.6 → 4.11 |
281+
| [1.7][] | Jan 26, 2021 | Jul 22, 2022 | 1.18 → 1.23 | 4.5 → 4.9 |
282+
| [1.6][] | Oct 26, 2021 | Apr 05, 2022 | 1.17 → 1.22 | 4.4 → 4.9 |
283+
| [1.5][] | Aug 11, 2021 | Jan 26, 2022 | 1.16 → 1.22 | 4.3 → 4.8 |
284+
| [1.4][] | Jun 15, 2021 | Oct 26, 2021 | 1.16 → 1.21 | 4.3 → 4.7 |
285+
| [1.3][] | Apr 08, 2021 | Aug 11, 2021 | 1.16 → 1.21 | 4.3 → 4.7 |
286+
| [1.2][] | Feb 10, 2021 | Jun 15, 2021 | 1.16 → 1.21 | 4.3 → 4.7 |
287+
| [1.1][] | Nov 24, 2020 | Apr 08, 2021 | 1.11 → 1.21 | 3.11 → 4.7 |
288+
| [1.0][] | Sep 02, 2020 | Feb 10, 2021 | 1.11 → 1.21 | 3.11 → 4.7 |
289+
| [0.16][] | Jul 23, 2020 | Nov 24, 2020 | 1.11 → 1.21 | 3.11 → 4.7 |
290+
| [0.15][] | May 06, 2020 | Sep 02, 2020 | 1.11 → 1.21 | 3.11 → 4.7 |
291+
| [0.14][] | Mar 11, 2020 | Jul 23, 2020 | 1.11 → 1.21 | 3.11 → 4.7 |
292+
| [0.13][] | Jan 21, 2020 | May 06, 2020 | 1.11 → 1.21 | 3.11 → 4.7 |
293+
| [0.12][] | Nov 27, 2019 | Mar 11, 2020 | 1.11 → 1.21 | 3.11 → 4.7 |
294+
| [0.11][] | Oct 10, 2019 | Jan 21, 2020 | 1.9 → 1.21 | 3.09 → 4.7 |
295+
296+
[s]: #kubernetes-supported-versions
297+
[1.16]: https://github.com/cert-manager/cert-manager/milestone/38
298+
[1.15]: ./release-notes/release-notes-1.15.md
299+
[1.14]: ./release-notes/release-notes-1.14.md
300+
[1.13]: ./release-notes/release-notes-1.13.md
301+
[1.12 LTS]: ./release-notes/release-notes-1.12.md
302+
[1.11]: ./release-notes/release-notes-1.11.md
303+
[1.10]: ./release-notes/release-notes-1.10.md
304+
[1.9]: ./release-notes/release-notes-1.9.md
305+
[1.8]: ./release-notes/release-notes-1.8.md
306+
[1.7]: ./release-notes/release-notes-1.7.md
307+
[1.6]: ./release-notes/release-notes-1.6.md
308+
[1.5]: ./release-notes/release-notes-1.5.md
309+
[1.4]: ./release-notes/release-notes-1.4.md
310+
[1.3]: ./release-notes/release-notes-1.3.md
311+
[1.2]: ./release-notes/release-notes-1.2.md
312+
[1.1]: ./release-notes/release-notes-1.1.md
313+
[1.0]: ./release-notes/release-notes-1.0.md
314+
[0.16]: ./release-notes/release-notes-0.16.md
315+
[0.15]: ./release-notes/release-notes-0.15.md
316+
[0.14]: ./release-notes/release-notes-0.14.md
317+
[0.13]: ./release-notes/release-notes-0.13.md
318+
[0.12]: ./release-notes/release-notes-0.12.md
319+
[0.11]: ./release-notes/release-notes-0.11.md

0 commit comments

Comments
 (0)