Skip to content

Commit bc94027

Browse files
Remove "Maintainer" role related notes and document responsibilities in the release process
Signed-off-by: Furkat Gofurov <[email protected]>
1 parent 7aac1a3 commit bc94027

File tree

4 files changed

+16
-40
lines changed

4 files changed

+16
-40
lines changed

.github/ISSUE_TEMPLATE/release_tracking.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,8 +52,8 @@ Week 15:
5252
* KubeCon idle week
5353

5454
Week 16:
55-
* [ ] [Release Lead] [Create the release-1.6 release branch](https://github.com/kubernetes-sigs/cluster-api/blob/main/docs/release/release-tasks.md#create-a-release-branch)
5655
* [ ] [Release Lead] [Cut the v1.6.0-rc.0 release](https://github.com/kubernetes-sigs/cluster-api/blob/main/docs/release/release-tasks.md#repeatedly-cut-a-release)
56+
* [ ] [Release Lead] [Update milestone applier and GitHub Actions](https://github.com/kubernetes-sigs/cluster-api/blob/main/docs/release/release-tasks.md#update-milestone-applier-and-github-actions)
5757
* [ ] [CI Manager] [Setup jobs and dashboards for the release-1.6 release branch](https://github.com/kubernetes-sigs/cluster-api/blob/main/docs/release/release-tasks.md#setup-jobs-and-dashboards-for-a-new-release-branch)
5858
* [ ] [Communications Manager] [Ensure the book for the new release is available](https://github.com/kubernetes-sigs/cluster-api/blob/main/docs/release/release-tasks.md#ensure-the-book-for-the-new-release-is-available)
5959

docs/release/release-tasks.md

Lines changed: 13 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ This document details the responsibilities and tasks for each role in the releas
2323
- [[Track] Bump dependencies](#track-bump-dependencies)
2424
- [Set a tentative release date for the next minor release](#set-a-tentative-release-date-for-the-next-minor-release)
2525
- [Assemble next release team](#assemble-next-release-team)
26-
- [Create a release branch](#create-a-release-branch)
26+
- [Update milestone applier and GitHub Actions](#update-milestone-applier-and-github-actions)
2727
- [[Continuously] Maintain the GitHub release milestone](#continuously-maintain-the-github-release-milestone)
2828
- [[Continuously] Bump the Go version](#continuously-bump-the-go-version)
2929
- [[Repeatedly] Cut a release](#repeatedly-cut-a-release)
@@ -37,6 +37,7 @@ This document details the responsibilities and tasks for each role in the releas
3737
- [Add docs to collect release notes for users and migration notes for provider implementers](#add-docs-to-collect-release-notes-for-users-and-migration-notes-for-provider-implementers)
3838
- [Update supported versions](#update-supported-versions)
3939
- [Ensure the book for the new release is available](#ensure-the-book-for-the-new-release-is-available)
40+
- [Generate weekly PR updates to post in Slack](#generate-weekly-pr-updates-to-post-in-slack)
4041
- [Create PR for release notes](#create-pr-for-release-notes)
4142
- [Change production branch in Netlify to the new release branch](#change-production-branch-in-netlify-to-the-new-release-branch)
4243
- [Update clusterctl links in the quickstart](#update-clusterctl-links-in-the-quickstart)
@@ -49,10 +50,6 @@ This document details the responsibilities and tasks for each role in the releas
4950
- [[Continuously] Monitor CI signal](#continuously-monitor-ci-signal)
5051
- [[Continuously] Reduce the amount of flaky tests](#continuously-reduce-the-amount-of-flaky-tests)
5152
- [[Continuously] Bug triage](#continuously-bug-triage)
52-
- [Maintainer](#maintainer)
53-
- [Responsibilities](#responsibilities-3)
54-
- [Tasks](#tasks-3)
55-
- [[Repeatedly] Publish the release](#repeatedly-publish-the-release)
5653

5754
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
5855

@@ -66,7 +63,7 @@ This document details the responsibilities and tasks for each role in the releas
6663
* Create and maintain the GitHub release milestone
6764
* Track tasks needed to add support for new Kubernetes versions in upcoming releases
6865
* Ensure a retrospective happens
69-
* Ensure a maintainer is available when a release needs to be cut.
66+
* Ensure one of the [maintainers](https://github.com/kubernetes-sigs/cluster-api/blob/main/OWNERS_ALIASES) is available when a release needs to be cut.
7067
* Staffing:
7168
* Assemble the release team for the next release cycle
7269
* Ensure a release lead for the next release cycle is selected and trained
@@ -162,17 +159,16 @@ We should take a look at the following dependencies:
162159
There is currently no formalized process to assemble the release team.
163160
As of now we ask for volunteers in Slack and office hours.
164161

165-
#### Create a release branch
162+
#### Update milestone applier and GitHub Actions
166163

167-
The goal of this task is to ensure we have a release branch and the milestone applier applies milestones accordingly.
164+
Once release branch is created by GitHub Automation, the goal of this task would be to ensure we have the milestone
165+
applier that applies milestones accordingly and to update GitHub actions to work with new release version.
168166
From this point forward changes which should land in the release have to be cherry-picked into the release branch.
169-
170-
1. Ask the [Maintainer](#maintainer) to create a new release branch.
171167

172-
2. Update the [milestone applier config](https://github.com/kubernetes/test-infra/blob/0b17ef5ffd6c7aa7d8ca1372d837acfb85f7bec6/config/prow/plugins.yaml#L371) accordingly (e.g. `release-1.4: v1.4` and `main: v1.5`)
168+
1. Update the [milestone applier config](https://github.com/kubernetes/test-infra/blob/0b17ef5ffd6c7aa7d8ca1372d837acfb85f7bec6/config/prow/plugins.yaml#L371) accordingly (e.g. `release-1.4: v1.4` and `main: v1.5`)
173169
<br>Prior art: [cluster-api: update milestone applier config for v1.3](https://github.com/kubernetes/test-infra/pull/26631)
174170

175-
3. Update the GitHub Actions to work with the new release version.
171+
2. Update the GitHub Actions to work with the new release version.
176172
<br>Prior art: [Update actions for 1.5 and make names consistent](https://github.com/kubernetes-sigs/cluster-api/pull/9115)
177173

178174
#### [Continuously] Maintain the GitHub release milestone
@@ -232,7 +228,10 @@ to a newer Go minor version according to our [backport policy](./../../CONTRIBUT
232228
```
233229
234230
4. Publish the release in GitHub:
235-
1. Ask the [Maintainer](#maintainer) to publish the release in GitHub.
231+
1. Reach out to one of the maintainers over the Slack to publish the release in GitHub.
232+
* **NOTE:** clusterctl will have issues installing providers between the time the release tag is cut and the Github release is published. See [issue 7889](https://github.com/kubernetes-sigs/cluster-api/issues/7889) for more details.
233+
* The draft release should be automatically created via the [Create Release GitHub Action](https://github.com/kubernetes-sigs/cluster-api/actions/workflows/release.yaml) with release notes previously committed to the repo by the release team. Ensure by reminding the maintainer that release is flagged as `pre-release` for all `beta` and `rc` releases or `latest` for a new release in the most recent release branch.
234+
236235
5. Publish `clusterctl` to Homebrew by bumping the version in [clusterctl.rb](https://github.com/Homebrew/homebrew-core/blob/master/Formula/c/clusterctl.rb).
237236
<br>**Notes**:
238237
* This is only done for new latest stable releases, not for beta / RC releases and not for previous release branches.
@@ -543,25 +542,4 @@ The goal of bug triage is to triage incoming issues and if necessary flag them w
543542
and add them to the milestone of the current release.
544543
545544
We probably have to figure out some details about the overlap between the bug triage task here, release leads
546-
and Cluster API maintainers.
547-
548-
## Maintainer
549-
550-
The Maintainer must be a person with write access to the Cluster API repo. They can hold another role in the release team. The Maintainer need only be involved in the release as required on days when releases are cut. They are not expected to take part in release team meetings or other activities, but should feel free to do so.
551-
552-
### Responsibilities
553-
554-
* Be available on release day in case the release team needs help with tag creation.
555-
* Publish the release.
556-
* Ensure a substitute is nominated if they are not available.
557-
558-
### Tasks
559-
560-
#### [Repeatedly] Publish the release
561-
562-
**NOTE:** clusterctl will have issues installing providers between the time the release tag is cut and the Github release is published. See [issue 7889](https://github.com/kubernetes-sigs/cluster-api/issues/7889) for more details
563-
564-
Publish the release.
565-
566-
1. The draft release should be automatically created via the [Create Release GitHub Action](https://github.com/kubernetes-sigs/cluster-api/actions/workflows/release.yml) with release notes previously committed to the repo by the release team.
567-
2. Publish the release. Ensure release is flagged as `pre-release` for all `beta` and `rc` releases or `latest` for a new release in the most recent release branch.
545+
and Cluster API maintainers.

docs/release/release-team.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -71,8 +71,7 @@ As noted above, making changes to the CAPI release cadence is out of scope for
7171
- **Communications/Docs/Release Notes Manager**: Responsible for communicating key dates to the community, improving release process documentation, and polishing release notes. Also responsible for ensuring the user-facing Netlify book and provider upgrade documentation are up to date.
7272
- **CI Signal/Bug Triage/Automation Manager**: Assumes the responsibility of the quality gate for the release and makes sure blocking issues and bugs are triaged and dealt with in a timely fashion. Helps improve release automation and tools.
7373
- **Team member**: Any Release Team lead or manager may select one or more additional members to help with their tasks. These team members will help fulfill future Release Team staffing requirements and continue to grow the CAPI community in general.
74-
- **Maintainer**: Responsible for tasks which require write access to the Cluster API repo including creating release tags and creating a release branch. This role must be filled by someone on the [`cluster-api-maintainers` list](https://github.com/kubernetes-sigs/cluster-api/blob/main/OWNERS_ALIASES).
75-
*Note*: This is also documented in [Release tasks](./release-tasks.md) together with a mapping to specific tasks.
74+
*Note*: This is also documented in [Release tasks](./release-tasks.md) together with a mapping to specific tasks.
7675

7776
## Team repo permissions
7877
- Release notes (`CHANGELOG` folder)

docs/release/releases/release-1.7.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,5 +32,4 @@ After the `.0` release monthly patch release will be created.
3232
|-------------------------------------------|-------------------------------------------------------------------------------------------|----------------------------------------|
3333
| Release Lead | TBD | TBD |
3434
| Communications/Docs/Release Notes Manager | TBD | TBD |
35-
| CI Signal/Bug Triage/Automation Manager | TBD | TBD |
36-
| Maintainer | TBD | TBD |
35+
| CI Signal/Bug Triage/Automation Manager | TBD | TBD |

0 commit comments

Comments
 (0)