Skip to content

Commit e208427

Browse files
SgtCoDFishSgtCoDFish
authored
Merge pull request #1563 from SgtCoDFish/supported-releases
Update supported releases page
2 parents f8833a3 + 199c78b commit e208427

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)