Skip to content

Commit 05e2a03

Browse files
authored
[Doc-only PR] Add release checklist template (#1555)
1 parent 4d8b02d commit 05e2a03

File tree

1 file changed

+49
-0
lines changed

1 file changed

+49
-0
lines changed
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# .NET Core Release Checklist
2+
3+
## Release Versions
4+
5+
_The set of .NET Core versions that are being released as a unit._
6+
7+
* 2.1.X: <runtime/SDK>
8+
* 3.1.X: <runtime/SDK>
9+
10+
1. - [ ] Update target branch to new version.
11+
- For 2.x:
12+
- [ ] If releasing 2.x, run auto-update (refer to docs).
13+
- For 3.x:
14+
- [ ] 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
15+
- [ ] if auto-PR updates are unavailable, checkout a local branch for the pertinent version and run darc updates(refer docs).
16+
- [ ] Push this local branch upstream and start the release PR for the N version that is to be released.
17+
1. - [ ] Version updates and confirmations
18+
- For 2.x:
19+
- [ ] Verify that `source-build/ProdConFeed.txt` contains the latest feed required for the release. For info on latest feed (refer OneNote).
20+
- [ ] Verify/update the ASP.NET versions (`MicrosoftAspNetCoreAllPackageVersion` and `MicrosoftAspNetCoreAppPackageVersion`) in dependencies.props.
21+
- [ ] Verify/update the `OfficialBuildId`s in updated repos (usually coreclr, corefx, core-setup).
22+
- For 3.x:
23+
- [ ] Verify that the `PrivateSourceBuiltArtifactsPackageVersion` in `eng/Versions.props` match N-1 release artifacts.
24+
1. - [ ] Build locally/in-CI and get to a clean build
25+
1. - [ ] Complete prebuilt and poison audit. Review the baseline changes to find out if there are any new prebuilts.
26+
1. - [ ] Verify the the packs included in the SDK are from source-build-reference-packages, not source-build, and have XML documentation comments.
27+
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).
28+
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.
29+
1. - [ ] Re-validate the SHA1s in Versions file with the manifest in VSU share dir
30+
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."
31+
- `git tag -s v<X.X.X-runtime/SDK> <SHA1>` . E.g - $ git tag -s v2.1.0-runtime c7012bcc8
32+
1. - [ ] Tag SDK version (e.g. "v2.1.300-SDK") with the same annotation, also preferably signed
33+
1. - [ ] Push these tags to GitHub
34+
- `git push <remote> v2.1.0-runtime && git push <remote> v2.1.300-SDK`
35+
36+
Do not use "git push --tags" unless you have a fresh repo with no other tags - this will push all your tags.
37+
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
38+
1. - [ ] Notify the distro maintainer/s about the release tags
39+
1. - [ ] Download the tarball from CI
40+
1. - [ ] Upload the tarball to Azure blob feed for source-build
41+
42+
<Source-build-blob-feed-container>/redhat/<branch_version>/<SDK_version>/dotnet-<sdk_version>-<RID>.tar.gz
43+
44+
1. - [ ] Similarly, download Private.SourceBuilt.Artifacts.XX.tar.gz from CI and upload it to source-built-artifacts blob container
45+
1. - [ ] Write a post-mortem for the release
46+
47+
### Additional notes
48+
49+
See the .NET Core A&D OneNote -> Tarball section -> Source-build release checklist.

0 commit comments

Comments
 (0)