.NET Core Release (June)

[mthalman]

.NET Core Release

Release Versions

The set of .NET Core versions that are being released as a unit.

• 2.1.19/2.1.807
• 3.1.5/3.1.301

1. Master Branch Tasks

1. • Merge appropriate commits from nightly branch. Things to check:
     • New/EOL distro (Add Dockerfiles for Alpine 3.12 #1971)
     • Infrastructure changes
     • PowerShell version
     • Check for additional changes by diffing the master and nightly branches
2. • Wait for .NET Core archive files (.zip, .tar.gz) to be available at blob storage location
3. • Run update-dependencies tool to update all the necessary files to reflect the specified .NET Core versions (run this command for each version being released):
     • dotnet run --project .\eng\update-dependencies\update-dependencies.csproj --sdk-version 2.1.807 --runtime-version 2.1.19 --aspnet-version 2.1.19
     • dotnet run --project .\eng\update-dependencies\update-dependencies.csproj --sdk-version 3.1.301 --runtime-version 3.1.5 --aspnet-version 3.1.5
4. • Inspect generated changes for correctness
5. • Commit generated changes
6. • Create PR
7. • Get PR signoff
8. • Merge PR
9. • Wait for changes to be mirrored to internal dotnet-docker repo (internal MSFT link)

10. • Build images - Queue build stage of dotnet-docker pipeline (internal MSFT link) with variables:

      All releases:

       stages: build
      

      Servicing release:

       imageBuilder.pathArgs: --path '2.1*' --path '3.1*'
      

      Preview release:

       imageBuilder.pathArgs: --path '5.0*'
      

11. • Wait for NuGet packages to be published during release tic-toc

12. • Test and publish images - Queue build of dotnet-docker pipeline (internal MSFT link) with variables:

      All releases:

       stages: test;publish
       sourceBuildId: <Build ID from the build stage>
      

      Servicing release:

       imageBuilder.pathArgs: --path '2.1*' --path '3.1*'
      

      Preview release:

       imageBuilder.pathArgs: --path '5.0*'
      

13. • Confirm images have been ingested by MCR
14. • Confirm READMEs have been updated in Docker Hub

2. Sample Images (Not needed for Preview-only release)

1. • Confirm build for dotnet-docker-samples (internal MSFT link) was queued. This will be queued automatically by dotnet-docker-tools-check-base-image-updates when it detects that the product images have been updated (detection runs on a schedule). Alternatively, you can manually queue the samples build.
2. • Confirm sample images have been ingested by MCR
3. • Confirm README has been updated in Docker Hub for microsoft-dotnet-core-samples

3. Nightly Branch Tasks (Not needed for Preview-only release)

1. • Merge master branch to nightly
2. • Run the same update-dependencies command(s) in nightly that were run for the master branch
3. • Inspect generated changes for correctness
4. • Commit generated changes
5. • Create PR
6. • Get PR signoff
7. • Merge PR
8. • Wait for automatically queued CI build to finish on dotnet-docker-nightly pipeline (internal MSFT link)
9. • Confirm images have been ingested by MCR
10. • Confirm READMEs have been updated in Docker Hub