-
Notifications
You must be signed in to change notification settings - Fork 14.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Adding a release page under "Release Information"
- Loading branch information
Showing
17 changed files
with
798 additions
and
1,638 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,15 @@ | ||
# See the OWNERS docs at https://go.k8s.io/owners | ||
|
||
# This is the directory for English source content. | ||
# Teams and members are visible at https://github.com/orgs/kubernetes/teams. | ||
|
||
reviewers: | ||
- sig-docs-en-reviews | ||
- release-engineering-reviewers | ||
|
||
approvers: | ||
- sig-docs-en-owners | ||
- release-engineering-approvers | ||
|
||
labels: | ||
- sig/release |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,27 @@ | ||
--- | ||
linktitle: Release History | ||
title: Releases | ||
type: docs | ||
--- | ||
|
||
|
||
<!-- overview --> | ||
|
||
The Kubernetes project maintains release branches for the most recent three minor releases ({{< skew latestVersion >}}, {{< skew prevMinorVersion >}}, {{< skew oldestMinorVersion >}}). Kubernetes 1.19 and newer receive approximately 1 year of patch support. Kubernetes 1.18 and older received approximately 9 months of patch support. | ||
|
||
Kubernetes versions are expressed as **x.y.z**, | ||
where **x** is the major version, **y** is the minor version, and **z** is the patch version, following [Semantic Versioning](https://semver.org/) terminology. | ||
|
||
More information in the [version skew policy](/releases/version-skew-policy/) document. | ||
|
||
<!-- body --> | ||
|
||
## Release History | ||
|
||
{{< release-data >}} | ||
|
||
## Upcoming Release | ||
|
||
Check out the [schedule](https://github.com/kubernetes/sig-release/tree/master/releases/release-{{< skew nextMinorVersion >}}) for the upcoming **{{< skew nextMinorVersion >}}** Kubernetes release! | ||
|
||
## Helpful Resources |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,26 @@ | ||
--- | ||
title: Download Kubernetes | ||
type: docs | ||
--- | ||
## Core Kubernetes components | ||
|
||
Find links to download Kubernetes components (and their checksums) in the [CHANGELOG](https://github.com/kubernetes/kubernetes/tree/master/CHANGELOG) files. | ||
|
||
Alternately, use [downloadkubernetes.com](https://www.downloadkubernetes.com/) to filter by version and architecture. | ||
|
||
## kubectl | ||
|
||
<!-- overview --> | ||
The Kubernetes command-line tool, [kubectl](/docs/reference/kubectl/kubectl/), allows | ||
you to run commands against Kubernetes clusters. | ||
|
||
You can use kubectl to deploy applications, inspect and manage cluster resources, | ||
and view logs. For more information including a complete list of kubectl operations, see the | ||
[`kubectl` reference documentation](/docs/reference/kubectl/). | ||
|
||
kubectl is installable on a variety of Linux platforms, macOS and Windows. | ||
Find your preferred operating system below. | ||
|
||
- [Install kubectl on Linux](/docs/tasks/tools/install-kubectl-linux) | ||
- [Install kubectl on macOS](/docs/tasks/tools/install-kubectl-macos) | ||
- [Install kubectl on Windows](/docs/tasks/tools/install-kubectl-windows) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
--- | ||
linktitle: Release Notes | ||
title: Notes | ||
type: docs | ||
description: > | ||
Kubernetes release notes. | ||
--- | ||
|
||
Release notes can be found by reading the [Changelog](https://github.com/kubernetes/kubernetes/tree/master/CHANGELOG) that matches your Kubernetes version. View the changelog for {{< skew latestVersion >}} on [GitHub](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-{{< skew latestVersion >}}.md). | ||
|
||
Alternately, release notes can be searched and filtered online at: [relnotes.k8s.io](relnotes.k8s.io). View filtered release notes for {{< skew latestVersion >}} on [relnotes.k8s.io](https://relnotes.k8s.io/?releaseVersions={{< skew latestVersion >}}.0). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,188 @@ | ||
--- | ||
title: Patch Release Details | ||
type: docs | ||
--- | ||
# Kubernetes Patch Releases | ||
|
||
Schedule and team contact information for Kubernetes patch releases. | ||
|
||
For general information about Kubernetes release cycle, see the | ||
[release process description]. | ||
|
||
## Cadence | ||
|
||
Our typical patch release cadence is monthly. It is | ||
commonly a bit faster (1 to 2 weeks) for the earliest patch releases | ||
after a 1.X minor release. Critical bug fixes may cause a more | ||
immediate release outside of the normal cadence. We also aim to not make | ||
releases during major holiday periods. | ||
|
||
## Contact | ||
|
||
See the [Release Managers page][release-managers] for full contact details on the Patch Release Team. | ||
|
||
Please give us a business day to respond - we may be in a different timezone! | ||
|
||
In between releases the team is looking at incoming cherry-pick | ||
requests on a weekly basis. The team will get in touch with | ||
submitters via GitHub PR, SIG channels in Slack, and direct messages | ||
in Slack and [email](mailto:release-managers-private@kubernetes.io) | ||
if there are questions on the PR. | ||
|
||
## Cherry-Picks | ||
|
||
Please follow the [cherry-pick process]. | ||
|
||
Cherry-picks must be merge-ready in GitHub with proper labels (eg: | ||
approved, lgtm, release note) and passing CI tests ahead of the | ||
cherry-pick deadline. This is typically two days before the target | ||
release, but may be more. Earlier PR readiness is better, as we | ||
need time to get CI signal after merging your cherry-picks ahead | ||
of the actual release. | ||
|
||
Cherry-pick PRs which miss merge criteria will be carried over and tracked | ||
for the next patch release. | ||
|
||
## Support Period | ||
|
||
In accordance with the [yearly support KEP][yearly-support], the Kubernetes | ||
Community will support active patch release series for a period of roughly | ||
fourteen (14) months. | ||
|
||
The first twelve months of this timeframe will be considered the standard | ||
period. | ||
|
||
Towards the end of the twelve month, the following will happen: | ||
|
||
- [Release Managers][release-managers] will cut a release | ||
- The patch release series will enter maintenance mode | ||
|
||
During the two-month maintenance mode period, Release Managers may cut | ||
additional maintenance releases to resolve: | ||
|
||
- CVEs (under the advisement of the Product Security Committee) | ||
- dependency issues (including base image updates) | ||
- critical core component issues | ||
|
||
At the end of the two-month maintenance mode period, the patch release series | ||
will be considered EOL (end of life) and cherry picks to the associated branch | ||
are to be closed soon afterwards. | ||
|
||
Note that the 28th of the month was chosen for maintenance mode and EOL target | ||
dates for simplicity (every month has it). | ||
|
||
## Upcoming Monthly Releases | ||
|
||
Timelines may vary with the severity of bug fixes, but for easier planning we | ||
will target the following monthly release points. Unplanned, critical | ||
releases may also occur in between these. | ||
|
||
| Monthly Patch Release | Target date | | ||
| --- | --- | | ||
| May 2021 | 2021-05-12 | | ||
| June 2021 | 2021-06-16 | | ||
| July 2021 | 2021-07-14 | | ||
|
||
## Detailed Release History for Active Branches | ||
|
||
### 1.21 | ||
|
||
**1.21** enters maintenance mode on **2022-04-28** | ||
|
||
End of Life for **1.21** is **2022-06-28** | ||
|
||
| PATCH RELEASE | CHERRY PICK DEADLINE | TARGET DATE | | ||
|--- |--- |--- | | ||
| 1.21.1 | 2021-05-07 | 2021-05-12 | | ||
|
||
### 1.20 | ||
|
||
**1.20** enters maintenance mode on **2021-12-28** | ||
|
||
End of Life for **1.20** is **2022-02-28** | ||
|
||
| PATCH RELEASE | CHERRY PICK DEADLINE | TARGET DATE | | ||
|--- |--- |--- | | ||
| 1.20.7 | 2021-05-07 | 2021-05-12 | | ||
| 1.20.6 | 2021-04-09 | 2021-04-14 | | ||
| 1.20.5 | 2021-03-12 | 2021-03-17 | | ||
| 1.20.4 | 2021-02-12 | 2021-02-18 | | ||
| 1.20.3 | [Conformance Tests Issue](https://groups.google.com/g/kubernetes-dev/c/oUpY9vWgzJo) | 2021-02-17 | | ||
| 1.20.2 | 2021-01-08 | 2021-01-13 | | ||
| 1.20.1 | [Tagging Issue](https://groups.google.com/g/kubernetes-dev/c/dNH2yknlCBA) | 2020-12-18 | | ||
|
||
### 1.19 | ||
|
||
**1.19** enters maintenance mode on **2021-08-28** | ||
|
||
End of Life for **1.19** is **2021-10-28** | ||
|
||
| PATCH RELEASE | CHERRY PICK DEADLINE | TARGET DATE | | ||
|--- |--- |--- | | ||
| 1.19.11 | 2021-05-07 | 2021-05-12 | | ||
| 1.19.10 | 2021-04-09 | 2021-04-14 | | ||
| 1.19.9 | 2021-03-12 | 2021-03-17 | | ||
| 1.19.8 | 2021-02-12 | 2021-02-17 | | ||
| 1.19.7 | 2021-01-08 | 2021-01-13 | | ||
| 1.19.6 | [Tagging Issue](https://groups.google.com/g/kubernetes-dev/c/dNH2yknlCBA) | 2020-12-18 | | ||
| 1.19.5 | 2020-12-04 | 2020-12-09 | | ||
| 1.19.4 | 2020-11-06 | 2020-11-11 | | ||
| 1.19.3 | 2020-10-09 | 2020-10-14 | | ||
| 1.19.2 | 2020-09-11 | 2020-09-16 | | ||
| 1.19.1 | 2020-09-04 | 2020-09-09 | | ||
|
||
### 1.18 | ||
|
||
**1.18** enters maintenance mode on **2021-04-28** | ||
|
||
End of Life for **1.18** is **2021-05-12** | ||
|
||
| PATCH RELEASE | CHERRY PICK DEADLINE | TARGET DATE | | ||
|--- |--- |--- | | ||
| 1.18.19 | 2021-05-07 | 2021-05-12 | | ||
| 1.18.18 | 2021-04-09 | 2021-04-14 | | ||
| 1.18.17 | 2021-03-12 | 2021-03-17 | | ||
| 1.18.16 | 2021-02-12 | 2021-02-17 | | ||
| 1.18.15 | 2021-01-08 | 2021-01-13 | | ||
| 1.18.14 | [Tagging Issue](https://groups.google.com/g/kubernetes-dev/c/dNH2yknlCBA) | 2020-12-18 | | ||
| 1.18.13 | 2020-12-04 | 2020-12-09 | | ||
| 1.18.12 | N/A | 2020-11-12 | | ||
| 1.18.11 | [No-op release](https://groups.google.com/g/kubernetes-dev/c/nJix1xLQvZE) | 2020-11-11 | | ||
| 1.18.10 | 2020-10-09 | 2020-10-14 | | ||
| 1.18.9 | 2020-09-11 | 2020-09-16 | | ||
| 1.18.8 | N/A | 2020-08-13 | | ||
| 1.18.7 | 2020-08-07 | 2020-08-12 | | ||
| 1.18.6 | 2020-07-10 | 2020-07-15 | | ||
| 1.18.5 | 2020-06-25 | 2020-06-26 | | ||
| 1.18.4 | 2020-06-12 | 2020-06-17 | | ||
| 1.18.3 | 2020-05-15 | 2020-05-20 | | ||
| 1.18.2 | 2020-04-13 | 2020-04-16 | | ||
| 1.18.1 | 2020-04-06 | 2020-04-08 | | ||
|
||
## Non-Active Branch History | ||
|
||
These releases are no longer supported. | ||
|
||
| Minor Version | Final Patch Release | EOL date | | ||
| --- | --- | --- | | ||
| 1.17 | 1.17.17 | 2021-01-13 | | ||
| 1.16 | 1.16.15 | 2020-09-02 | | ||
| 1.15 | 1.15.12 | 2020-05-06 | | ||
| 1.14 | 1.14.10 | 2019-12-11 | | ||
| 1.13 | 1.13.12 | 2019-10-15 | | ||
| 1.12 | 1.12.10 | 2019-07-08 | | ||
| 1.11 | 1.11.10 | 2019-05-01 | | ||
| 1.10 | 1.10.13 | 2019-02-13 | | ||
| 1.9 | 1.9.11 | 2018-09-29 | | ||
| 1.8 | 1.8.15 | 2018-07-12 | | ||
| 1.7 | 1.7.16 | 2018-04-04 | | ||
| 1.6 | 1.6.13 | 2017-11-23 | | ||
| 1.5 | 1.5.8 | 2017-10-01 | | ||
| 1.4 | 1.4.12 | 2017-04-21 | | ||
| 1.3 | 1.3.10 | 2016-11-01 | | ||
| 1.2 | 1.2.7 | 2016-10-23 | | ||
|
||
[cherry-pick process]: https://git.k8s.io/community/contributors/devel/sig-release/cherry-picks.md | ||
[release-managers]: /release-managers.md | ||
[release process description]: https://git.k8s.io/community/contributors/devel/sig-release/release.md | ||
[yearly-support]: https://git.k8s.io/enhancements/keps/sig-release/1498-kubernetes-yearly-support-period/README.md |
Oops, something went wrong.