Skip to content

Latest commit

 

History

History
201 lines (164 loc) · 17.9 KB

process.md

File metadata and controls

201 lines (164 loc) · 17.9 KB
Raw

Releases, Features, Hotfixes

This document describes how to contribute features or hotfixes, and how new Gardener releases are usually scheduled, validated, etc.

Releases

The @gardener-maintainers are trying to provide a new release roughly every other week (depending on their capacity and the stability/robustness of the master branch).

Hotfixes are usually maintained for the latest three minor releases, though, there are no fixed release dates.

Release Responsible Plan

Version Week No Begin Validation Phase Due Date Release Responsible
v1.76 Week 29-30 July 17, 2023 July 30, 2023 @plkokanov
v1.77 Week 31-32 July 31, 2023 August 13, 2023 @ialidzhikov
v1.78 Week 33-34 August 14, 2023 August 27, 2023 @acumino
v1.79 Week 35-36 August 28, 2023 September 10, 2023 @shafeeqes
v1.80 Week 37-38 September 11, 2023 September 24, 2023 @ScheererJ
v1.81 Week 39-40 September 25, 2023 October 8, 2023 @ary1992
v1.82 Week 41-42 October 9, 2023 October 22, 2023 @timuthy
v1.83 Week 43-44 October 23, 2023 November 5, 2023 @oliver-goetz
v1.84 Week 45-46 November 6, 2023 November 19, 2023 @rfranzke
v1.85 Week 47-48 November 20, 2023 December 3, 2023 @plkokanov
v1.86 Week 49-50 December 4, 2023 December 17, 2023 @ialidzhikov
v1.87 Week 01-04 January 1, 2024 January 28, 2024 @acumino

Apart from the release of the next version, the release responsible is also taking care of potential hotfix releases of the last three minor versions. The release responsible is the main contact person for coordinating new feature PRs for the next minor versions or cherry-pick PRs for the last three minor versions.

Click to expand the archived release responsible associations!
Version Week No Begin Validation Phase Due Date Release Responsible
v1.17 Week 07-08 February 15, 2021 February 28, 2021 @rfranzke
v1.18 Week 09-10 March 1, 2021 March 14, 2021 @danielfoehrKn
v1.19 Week 11-12 March 15, 2021 March 28, 2021 @timebertt
v1.20 Week 13-14 March 29, 2021 April 11, 2021 @vpnachev
v1.21 Week 15-16 April 12, 2021 April 25, 2021 @timuthy
v1.22 Week 17-18 April 26, 2021 May 9, 2021 @BeckerMax
v1.23 Week 19-20 May 10, 2021 May 23, 2021 @ialidzhikov
v1.24 Week 21-22 May 24, 2021 June 5, 2021 @stoyanr
v1.25 Week 23-24 June 7, 2021 June 20, 2021 @rfranzke
v1.26 Week 25-26 June 21, 2021 July 4, 2021 @danielfoehrKn
v1.27 Week 27-28 July 5, 2021 July 18, 2021 @timebertt
v1.28 Week 29-30 July 19, 2021 August 1, 2021 @ialidzhikov
v1.29 Week 31-32 August 2, 2021 August 15, 2021 @timuthy
v1.30 Week 33-34 August 16, 2021 August 29, 2021 @BeckerMax
v1.31 Week 35-36 August 30, 2021 September 12, 2021 @stoyanr
v1.32 Week 37-38 September 13, 2021 September 26, 2021 @vpnachev
v1.33 Week 39-40 September 27, 2021 October 10, 2021 @voelzmo
v1.34 Week 41-42 October 11, 2021 October 24, 2021 @plkokanov
v1.35 Week 43-44 October 25, 2021 November 7, 2021 @kris94
v1.36 Week 45-46 November 8, 2021 November 21, 2021 @timebertt
v1.37 Week 47-48 November 22, 2021 December 5, 2021 @danielfoehrKn
v1.38 Week 49-50 December 6, 2021 December 19, 2021 @rfranzke
v1.39 Week 01-04 January 3, 2022 January 30, 2022 @ialidzhikov, @timuthy
v1.40 Week 05-06 January 31, 2022 February 13, 2022 @BeckerMax
v1.41 Week 07-08 February 14, 2022 February 27, 2022 @plkokanov
v1.42 Week 09-10 February 28, 2022 March 13, 2022 @kris94
v1.43 Week 11-12 March 14, 2022 March 27, 2022 @rfranzke
v1.44 Week 13-14 March 28, 2022 April 10, 2022 @timebertt
v1.45 Week 15-16 April 11, 2022 April 24, 2022 @acumino
v1.46 Week 17-18 April 25, 2022 May 8, 2022 @ialidzhikov
v1.47 Week 19-20 May 9, 2022 May 22, 2022 @shafeeqes
v1.48 Week 21-22 May 23, 2022 June 5, 2022 @ary1992
v1.49 Week 23-24 June 6, 2022 June 19, 2022 @plkokanov
v1.50 Week 25-26 June 20, 2022 July 3, 2022 @rfranzke
v1.51 Week 27-28 July 4, 2022 July 17, 2022 @timebertt
v1.52 Week 29-30 July 18, 2022 July 31, 2022 @acumino
v1.53 Week 31-32 August 1, 2022 August 14, 2022 @kris94
v1.54 Week 33-34 August 15, 2022 August 28, 2022 @ialidzhikov
v1.55 Week 35-36 August 29, 2022 September 11, 2022 @oliver-goetz
v1.56 Week 37-38 September 12, 2022 September 25, 2022 @shafeeqes
v1.57 Week 39-40 September 26, 2022 October 9, 2022 @ary1992
v1.58 Week 41-42 October 10, 2022 October 23, 2022 @plkokanov
v1.59 Week 43-44 October 24, 2022 November 6, 2022 @rfranzke
v1.60 Week 45-46 November 7, 2022 November 20, 2022 @acumino
v1.61 Week 47-48 November 21, 2022 December 4, 2022 @ialidzhikov
v1.62 Week 49-50 December 5, 2022 December 18, 2022 @oliver-goetz
v1.63 Week 01-04 January 2, 2023 January 29, 2023 @shafeeqes
v1.64 Week 05-06 January 30, 2023 February 12, 2023 @ary1992
v1.65 Week 07-08 February 13, 2023 February 26, 2023 @timuthy
v1.66 Week 09-10 February 27, 2023 March 12, 2023 @plkokanov
v1.67 Week 11-12 March 13, 2023 March 26, 2023 @rfranzke
v1.68 Week 13-14 March 27, 2023 April 9, 2023 @acumino
v1.69 Week 15-16 April 10, 2023 April 23, 2023 @oliver-goetz
v1.70 Week 17-18 April 24, 2023 May 7, 2023 @ialidzhikov
v1.71 Week 19-20 May 8, 2023 May 21, 2023 @shafeeqes
v1.72 Week 21-22 May 22, 2023 June 4, 2023 @ary1992
v1.73 Week 23-24 June 5, 2023 June 18, 2023 @timuthy
v1.74 Week 25-26 June 19, 2023 July 2, 2023 @oliver-goetz
v1.75 Week 27-28 July 3, 2023 July 16, 2023 @rfranzke

Release Validation

The release phase for a new minor version lasts two weeks. Typically, the first week is used for the validation of the release. This phase includes the following steps:

  1. master (or latest release-* branch) is deployed to a development landscape that already hosts some existing seed and shoot clusters.
  2. An extended test suite is triggered by the "release responsible" which:
    1. executes the Gardener integration tests for different Kubernetes versions, infrastructures, and Shoot settings.
    2. executes the Kubernetes conformance tests.
    3. executes further tests like Kubernetes/OS patch/minor version upgrades.
  3. Additionally, every four hours (or on demand) more tests (e.g., including the Kubernetes e2e test suite) are executed for different infrastructures.
  4. The "release responsible" is verifying new features or other notable changes (derived of the draft release notes) in this development system.

Usually, the new release is triggered in the beginning of the second week if all tests are green, all checks were successful, and if all of the planned verifications were performed by the release responsible.

Contributing New Features or Fixes

Please refer to the Gardener contributor guide. Besides a lot of a general information, it also provides a checklist for newly created pull requests that may help you to prepare your changes for an efficient review process. If you are contributing a fix or major improvement, please take care to open cherry-pick PRs to all affected and still supported versions once the change is approved and merged in the master branch.

⚠️ Please ensure that your modifications pass the verification checks (linting, formatting, static code checks, tests, etc.) by executing

make verify

before filing your pull request.

The guide applies for both changes to the master and to any release-* branch. All changes must be submitted via a pull request and be reviewed and approved by at least one code owner.

TODO Statements

Sometimes, TODO statements are being introduced when one cannot follow up immediately with certain tasks or when temporary migration code is required. In order to properly follow-up with such TODOs and to prevent them from piling up without getting attention, the following rules should be followed:

  • Each TODO statement should have an associated person and state when it can be removed. Example: 
    // TODO(<github-username>): Remove this code after v1.75 has been released.
  • When the task depends on a certain implementation, a GitHub issue should be opened and referenced in the statement. Example: 
    // TODO(<github-username>): Remove this code after https://github.com/gardener/gardener/issues/<issue-number> has been implemented.
    The associated person should actively drive the implementation of the referenced issue (unless it cannot be done because of third-party dependencies or conditions) so that the TODO statement does not get stale.
  • TODO statements without actionable tasks or those that are unlikely to ever be implemented (maybe because of very low priorities) should not be specified in the first place. If a TODO is specified, the associated person should make sure to actively follow-up.

Cherry Picks

This section explains how to initiate cherry picks on release branches within the gardener/gardener repository.

Prerequisites

Before you initiate a cherry pick, make sure that the following prerequisites are accomplished.

  • A pull request merged against the master branch.
  • The release branch exists (check in the branches section).
  • Have the gardener/gardener repository cloned as follows:
    • the origin remote should point to your fork (alternatively this can be overwritten by passing FORK_REMOTE=<fork-remote>).
    • the upstream remote should point to the Gardener GitHub org (alternatively this can be overwritten by passing UPSTREAM_REMOTE=<upstream-remote>).
  • Have hub installed, which is most easily installed via go get github.com/github/hub assuming you have a standard golang development environment.
  • A GitHub token which has permissions to create a PR in an upstream branch.

Initiate a Cherry Pick

  • Run the [cherry pick script][cherry-pick-script].

    This example applies a master branch PR #3632 to the remote branch upstream/release-v3.14:

    GITHUB_USER=<your-user> hack/cherry-pick-pull.sh upstream/release-v3.14 3632

    • Be aware the cherry pick script assumes you have a git remote called upstream that points at the Gardener GitHub org.

    • You will need to run the cherry pick script separately for each patch release you want to cherry pick to. Cherry picks should be applied to all active release branches where the fix is applicable.

    • When asked for your GitHub password, provide the created GitHub token rather than your actual GitHub password. Refer mislav/hub#2655 (comment)

  • cherry-pick-script