Link to release cadence from minor section

Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
pull/3254/head
Stefan Prodan 2 years ago
parent 926842a216
commit 1a8798a5d4
No known key found for this signature in database
GPG Key ID: 3299AEB0E4085BAF

@ -99,14 +99,9 @@ Note that breaking changes may occur if required by a security vulnerability fix
In addition, minor releases are used when updating Kubernetes dependencies such In addition, minor releases are used when updating Kubernetes dependencies such
as `k8s.io/api` from one minor version to another. as `k8s.io/api` from one minor version to another.
In effect, this means a new minor version will at least be released for all Flux In effect, this means a controller minor version will be released at least every four months, after each
controllers approximately every four months, following each Kubernetes minor version release. Kubernetes minor version release. For in-depth information about this, please refer to the
To properly validate the controllers against the latest Kubernetes version, [release cadence](#release-cadence) section of this document.
we typically allocate a time window of around two weeks for end-to-end testing of Flux controllers.
It is worth noting that in certain scenarios where project dependencies are not in sync with
the Kubernetes version or conflicts arise, this two-week timeframe may prove insufficient,
requiring additional time to address the issues appropriately.
### Major releases ### Major releases
@ -117,11 +112,17 @@ and a support window of one year will be provided for the previous major version
## Release cadence ## Release cadence
Flux controllers are at least released at the same rate as Kubernetes, following their cadence of three Flux controllers are _at least_ released at the same rate as Kubernetes, following their cadence of three
minor releases per year. After each Kubernetes minor release, all controllers are tested against the latest minor releases per year.
Kubernetes version and then released approximately two weeks after Kubernetes.
To properly validate the controllers against the latest Kubernetes version,
we typically allocate a time window of around two weeks for end-to-end testing of Flux controllers.
The newly released controllers offer support for Kubernetes N-2 minor versions. The newly released controllers offer support for Kubernetes N-2 minor versions.
It is worth noting that in certain scenarios where project dependencies are not in sync with
the Kubernetes version or conflicts arise, this two-week timeframe may prove insufficient,
requiring additional time to address the issues appropriately.
A Flux controller may have more than three minor releases per year, if maintainers decide to ship a A Flux controller may have more than three minor releases per year, if maintainers decide to ship a
new feature or optimisation ahead of schedule. new feature or optimisation ahead of schedule.

@ -42,9 +42,9 @@ Note that breaking changes may occur if required by a security vulnerability fix
Minor releases are used when updating the Flux controllers or Kubernetes dependencies Minor releases are used when updating the Flux controllers or Kubernetes dependencies
from one minor version to another. from one minor version to another.
In effect, this means a Flux minor version will be released at least every four months after each In effect, this means a Flux minor version will be released at least every four months, after each
Kubernetes minor version release. To properly validate the Flux CLI and controllers against Kubernetes minor version release. For in-depth information about this, please refer to the
the latest Kubernetes version, we reserve a time window of at least two weeks for end-to-end testing. [release cadence](#release-cadence) section of this document.
### Major releases ### Major releases
@ -55,11 +55,15 @@ and a support window of one year will be provided for the previous major version
## Release cadence ## Release cadence
Flux is at least released at the same rate as Kubernetes, following their cadence of three Flux is _at least_ released at the same rate as Kubernetes, following their cadence of three
minor releases per year. After each Kubernetes minor release, the CLI and all controllers are minor releases per year. After each Kubernetes minor release, the CLI and all controllers are
tested against the latest Kubernetes version and are released approximately two weeks after Kubernetes. tested against the latest Kubernetes version and are released approximately two weeks after Kubernetes.
The newly released Flux version offers support for Kubernetes N-2 minor versions. The newly released Flux version offers support for Kubernetes N-2 minor versions.
It is worth noting that in certain scenarios where project dependencies are not in sync with
the Kubernetes version or conflicts arise, this two-week timeframe may prove insufficient,
requiring additional time to address the issues appropriately.
Flux may have more than three minor releases per year if maintainers decide to ship a Flux may have more than three minor releases per year if maintainers decide to ship a
new feature or optimization ahead of schedule. new feature or optimization ahead of schedule.

@ -216,12 +216,12 @@ In some cases, it may be necessary to release a [release
candidate](controllers.md#release-candidates) of a controller. candidate](controllers.md#release-candidates) of a controller.
To create a first release candidate, follow the steps to create a [minor To create a first release candidate, follow the steps to create a [minor
release](#controller-minor-releases), but use the `rc.X` suffix for SemVer release](#controllers-minor-releases), but use the `rc.X` suffix for SemVer
version to release (e.g., `v1.2.0-rc.1`). version to release (e.g., `v1.2.0-rc.1`).
Once the release series branch is created, subsequent release candidates and Once the release series branch is created, subsequent release candidates and
the final (non-RC) release should follow the procedure for [patch controller the final (non-RC) release should follow the procedure for [patch controller
releases](#controller-patch-releases). releases](#controllers-patch-releases).
#### Controllers: preview releases #### Controllers: preview releases
@ -331,13 +331,12 @@ release](#distribution-minor-releases), but use the `rc.X` suffix for SemVer
version to release (e.g., `v2.2.0-rc.1`). version to release (e.g., `v2.2.0-rc.1`).
Once the release series branch is created, subsequent release candidates and Once the release series branch is created, subsequent release candidates and
the final (non-RC) release should follow the procedure for [patch controller the final (non-RC) release should follow the procedure for [patch releases](#distribution-patch-releases).
releases](#controller-patch-releases).
#### Distribution: release notes #### Distribution: release notes
The release notes template for Flux distributions is available in the The release notes template for Flux distributions is available in the
[release-notes-template.md](release-notes-template.md) file. [release-notes-template.md](https://github.com/fluxcd/flux2/blob/main/docs/release/release-notes-template.md) file.
## Backport changes for patch releases ## Backport changes for patch releases

Loading…
Cancel
Save