From 05e2a037c5bfcfc718ff2b76494a91bbe24eac68 Mon Sep 17 00:00:00 2001 From: Aditya Aggarwal Date: Tue, 23 Jun 2020 09:37:38 -0500 Subject: [PATCH] [Doc-only PR] Add release checklist template (#1555) --- .../releases/release_checklist.md | 49 +++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/releases/release_checklist.md diff --git a/.github/ISSUE_TEMPLATE/releases/release_checklist.md b/.github/ISSUE_TEMPLATE/releases/release_checklist.md new file mode 100644 index 0000000000..18c07d7799 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/releases/release_checklist.md @@ -0,0 +1,49 @@ +# .NET Core Release Checklist + +## Release Versions + +_The set of .NET Core versions that are being released as a unit._ + +* 2.1.X: +* 3.1.X: + +1. - [ ] Update target branch to new version. + - For 2.x: + - [ ] If releasing 2.x, run auto-update (refer to docs). + - For 3.x: + - [ ] if maestro auto-PR is active, then verify SHA1s in version.Details with manifest versions in VSU share dir (refer docs), make sure that we match the versions + - [ ] if auto-PR updates are unavailable, checkout a local branch for the pertinent version and run darc updates(refer docs). + - [ ] Push this local branch upstream and start the release PR for the N version that is to be released. +1. - [ ] Version updates and confirmations + - For 2.x: + - [ ] Verify that `source-build/ProdConFeed.txt` contains the latest feed required for the release. For info on latest feed (refer OneNote). + - [ ] Verify/update the ASP.NET versions (`MicrosoftAspNetCoreAllPackageVersion` and `MicrosoftAspNetCoreAppPackageVersion`) in dependencies.props. + - [ ] Verify/update the `OfficialBuildId`s in updated repos (usually coreclr, corefx, core-setup). + - For 3.x: + - [ ] Verify that the `PrivateSourceBuiltArtifactsPackageVersion` in `eng/Versions.props` match N-1 release artifacts. +1. - [ ] Build locally/in-CI and get to a clean build +1. - [ ] Complete prebuilt and poison audit. Review the baseline changes to find out if there are any new prebuilts. +1. - [ ] Verify the the packs included in the SDK are from source-build-reference-packages, not source-build, and have XML documentation comments. +1. - [ ] Remove new prebuilts, if any. Ideally any new prebuilts that show up in offline builds have to be removed. In some cases, new prebuilts show up in Production builds but gets purged in offline builds automatically as they are not packaged(they may not be needed for the actual build). +1. - [ ] If significant delays are anticipated, notify the distro maintainer with PR link mentioning that a PR is ready, but we're waiting on the final validation. Do not tag the release until we have the final validation for the Microsoft build. +1. - [ ] Re-validate the SHA1s in Versions file with the manifest in VSU share dir +1. - [ ] Tag runtime version (e.g. "v2.1.0-runtime") with an annotated (preferably signed) tag including runtime and SDK versions, e.g. "Release for 2.1.0 runtime and 2.1.300 SDK." + - `git tag -s v ` . E.g - $ git tag -s v2.1.0-runtime c7012bcc8 +1. - [ ] Tag SDK version (e.g. "v2.1.300-SDK") with the same annotation, also preferably signed +1. - [ ] Push these tags to GitHub + - `git push v2.1.0-runtime && git push v2.1.300-SDK` + + Do not use "git push --tags" unless you have a fresh repo with no other tags - this will push all your tags. +1. - [ ] If there's a respin, retag the with the new changes. A sub-patch version tag for SDK and runtime would have to be generated. E.g - v2.1.300.1-SDK +1. - [ ] Notify the distro maintainer/s about the release tags +1. - [ ] Download the tarball from CI +1. - [ ] Upload the tarball to Azure blob feed for source-build + + /redhat///dotnet--.tar.gz + +1. - [ ] Similarly, download Private.SourceBuilt.Artifacts.XX.tar.gz from CI and upload it to source-built-artifacts blob container +1. - [ ] Write a post-mortem for the release + +### Additional notes + +See the .NET Core A&D OneNote -> Tarball section -> Source-build release checklist. \ No newline at end of file