From 21a416b5f79a802c86b6c2b9b1403be8b523ca57 Mon Sep 17 00:00:00 2001 From: Zelin Hao Date: Mon, 3 Apr 2023 10:31:20 -0700 Subject: [PATCH] Restore the component release issue template (#3360) Signed-off-by: Zelin Hao Signed-off-by: Sayali Gaikawad Co-authored-by: Sayali Gaikawad --- .../component_release_template.md | 69 +++++++++++++++++++ .github/ISSUE_TEMPLATE/release_template.md | 2 +- 2 files changed, 70 insertions(+), 1 deletion(-) create mode 100644 .github/ISSUE_TEMPLATE/component_release_template.md diff --git a/.github/ISSUE_TEMPLATE/component_release_template.md b/.github/ISSUE_TEMPLATE/component_release_template.md new file mode 100644 index 0000000000..eee254d9f8 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/component_release_template.md @@ -0,0 +1,69 @@ +This is a component issue for __{REPLACE_WITH_RELEASE_VERSION}__. +Coming from [opensearch-build__REPLACE_ISSUE_NUMBER__](https://github.com/opensearch-project/opensearch-build/issues/__REPLACE_ISSUE_NUMBER__). Please follow the following checklist. +__Please refer to the DATES in that post__. + +
How to use this issue +

+ +## This Component Release Issue + +This issue captures the state of the OpenSearch release, on component/plugin level; its assignee is responsible for driving the release. Please contact them or @mention them on this issue for help. +Any release related work can be linked to this issue or added as comments to create visiblity into the release status. + +## Release Steps + +There are several steps to the release process; these steps are completed as the whole component release and components that are behind present risk to the release. The component owner resolves the tasks in this issue and communicate with the overall release owner to make sure each component are moving along as expected. + +Steps have completion dates for coordinating efforts between the components of a release; components can start as soon as they are ready far in advance of a future release. The most current set of dates is on the overall release issue linked at the top of this issue. + +## The Overall Release Issue + +Linked at the top of this issue, the overall release issue captures the state of the entire OpenSearch release including references to this issue, the release owner which is the assignee is responsible for communicating the release status broadly. Please contact them or @mention them on that issue for help. + +## What should I do if my plugin isn't making any changes? + +If including changes in this release, increment the version on `__{REPLACE_MAJOR_MINOR_PATCH}__` branch to `__{REPLACE_MAJOR_MINOR_PATCH}__` for Min/Core, and `__{REPLACE_MAJOR_MINOR_PATCH_0}__` for components. Otherwise, keep the version number unchanged for both. + +

+
+ +### Preparation + +- [ ] Assign this issue to a release owner. +- [ ] Finalize scope and feature set and update [the Public Roadmap](https://github.com/orgs/opensearch-project/projects/1). +- [ ] All the tasks in this issue have been reviewed by the release owner. +- [ ] Create, update, triage and label all features and issues targeted for this release with `v__REPLACE_MAJOR_MINOR_PATCH__`. + +### CI/CD + +- [ ] All code changes for `__{REPLACE_MAJOR_MINOR_PATCH}__` are complete. +- [ ] Ensure working and passing CI. +- [ ] Check that this repo is included in the [distribution manifest](https://github.com/opensearch-project/opensearch-build/blob/main/manifests/__REPLACE_MAJOR_MINOR_PATCH__). + +### Pre-Release + +- [ ] Update to the `__REPLACE_MAJOR_MINOR__` release branch in the [distribution manifest](https://github.com/opensearch-project/opensearch-build/blob/main/manifests/__REPLACE_MAJOR_MINOR_PATCH__). +- [ ] Increment the version on the parent branch to the next development iteration. +- [ ] Gather, review and publish release notes following the [rules](https://github.com/opensearch-project/opensearch-plugins/blob/main/RELEASE_NOTES.md) and back port it to the release branch.[git-release-notes](https://github.com/ariatemplates/git-release-notes) may be used to generate release notes from your commit history. +- [ ] Confirm that all changes for `__{REPLACE_MAJOR_MINOR_PATCH}__` have been merged. +- [ ] Add this repo to the [manifest](https://github.com/opensearch-project/opensearch-build/blob/main/manifests/) for the next developer iteration. + +### Release Testing + +- [ ] Find/fix bugs using latest tarball and docker image provided in parent release issue and update the release notes if necessary. +- [ ] Code Complete: Test within the distribution, ensuring integration, backwards compatibility, and performance tests pass. +- [ ] Sanity Testing: Sanity testing *and* fixing of critical issues found. +- [ ] File issues for all intermittent test failures. + +### Release + +- [ ] Complete [documentation](https://github.com/opensearch-project/documentation-website). +- [ ] Verify all issued labeled for this release are closed or labelled for the next release. +- [ ] Verify the release date mentioned in release notes is correct and matches actual release date. + +### Post Release + +- [ ] Prepare for an eventual security fix development iteration by incrementing the version on the release branch to the next eventual patch version. +- [ ] Add this repo to the [manifest](https://github.com/opensearch-project/opensearch-build/blob/main/manifests/) of the next eventual security patch version. +- [ ] [Suggest improvements](https://github.com/opensearch-project/opensearch-build/issues/new) to [this template](https://github.com/opensearch-project/opensearch-build/blob/main/.github/ISSUE_TEMPLATE/component_release_template.md). +- [ ] Conduct a retrospective, and publish its results. diff --git a/.github/ISSUE_TEMPLATE/release_template.md b/.github/ISSUE_TEMPLATE/release_template.md index 057bd5bc54..0b254c13a4 100644 --- a/.github/ISSUE_TEMPLATE/release_template.md +++ b/.github/ISSUE_TEMPLATE/release_template.md @@ -37,7 +37,7 @@ To aid in understanding the state of the release there is a table with status in - [ ] Update this issue so all `__REPLACE_RELEASE-__` placeholders have actual dates. - [ ] Document any new quality requirements or changes. - [ ] Finalize scope and feature set and update [the Public Roadmap](https://github.com/orgs/opensearch-project/projects/1). -- [ ] [Create a release issue in every component repo](https://github.com/opensearch-project/opensearch-plugins/blob/main/META.md#create-an-issue-in-all-plugin-repos) that links back to this issue, update Components section with these links. +- [ ] [Create a release issue in every component repo](https://github.com/opensearch-project/opensearch-plugins/blob/main/META.md#create-an-issue-in-all-plugin-repos) based on [component release issue template](https://github.com/opensearch-project/opensearch-build/blob/main/.github/ISSUE_TEMPLATE/component_release_template.md) and link back to this issue, update Components section with these links. - [ ] Ensure the label is created in each component repo for this new version, and the next minor release. [Create a version label](https://github.com/opensearch-project/opensearch-plugins/blob/main/META.md#create-or-update-labels-in-all-plugin-repos) - [ ] Ensure that all release issues created above are assigned to an owner in the component team. - [ ] Increase the build frequency for the this release from once a day (H 1 * * *) to once every hour (H/60 * * * *) in [jenkinsFile](https://github.com/opensearch-project/opensearch-build/blob/main/jenkins/check-for-build.jenkinsfile).