Release Checklist

This checklist will prepare v1.3.0 from v1.2.0 (minor release) or v1.3.1 from v1.3.0 (patch release). Adjust your version numbers accordingly.

Preparation

Search the code for TODOs and FIXMEs that should be resolved before releasing.
Update titles and labels for all PRs relevant for this release to aid in the changelog generation.

Automated release

Releases should be performed using the automated release pipeline.

Prepare temporary working branch

Create a temporary working branch to prepare the release. This branch should be based on main if preparing a minor release or be based on the existing release branch if it is a patch release.

ver=v1.3.1 # replace me
minor=$(echo ${ver} | cut -d '.' -f 1,2)
# optional suffix to add to the temporary branch name. Can be empty: suffix=
suffix=/foo
# if preparing a patch release, checkout existing release branch as base
git checkout release/${minor}
# if preparing a minor release, branch out from main instead
git checkout main
git pull
working_branch=tmp/${ver}${suffix}
git checkout -b ${working_branch}
git push origin ${working_branch}

Patch release

cherry-pick (only) the required commits from main
- Check PRs with label needs-backport to find candidates that should be included in a patch release.

trigger the automated release pipeline from the working branch created above:

gh workflow run release.yml --ref ${working_branch} -F version=${ver} -F kind=patch

wait for the pipeline to finish
while in editing mode for the release, clear the textbox, select the last patch release for the current release branch and click "Generate release notes".
look over the autogenerated draft release. When fixing the changelog, prioritize updating the PR title/labels/description and regenerating the changelog over fixing things in the final changelog. The changelog should be primarily aimed at users. Rule of thumb: first part of the sentence should describe what changed for the user, second part can describe what has been changed to achieve this.
publish.

Minor release

Merge ready PRs

trigger the automated release pipeline from the working branch created above:

gh workflow run release.yml --ref ${working_branch} -F version=${ver} -F kind=minor

wait for the pipeline to finish
while in editing mode for the release, clear the textbox, select the last minor release and click "Generate release notes".
look over the autogenerated draft release. When fixing the changelog, prioritize updating the PR title/labels/description and regenerating the changelog over fixing things in the final changelog. The changelog should be primarily aimed at users. Rule of thumb: first part of the sentence should describe what changed for the user, second part can describe what has been changed to achieve this.
publish.

Post release steps

Close fixed "known issues"
Milestones management
1. Create a new milestone for the next release
2. Add the next release manager and an approximate release date to the milestone description
3. Close the milestone for the release
4. Move open issues and PRs from closed milestone to next milestone
If the release is a minor version release, bump the pre-release version in the version.txt file.

Pipeline cleanup

When testing changes to the pipeline or when the pipeline fails during a release it might become necessary to clean up the images created by the pipeline. These are the necessary steps.

General

Depending on how far the pipeline ran we need to delete:

the working branch (remove automated commits made by the process, keep any cherry picks)
the release tag create by the pipeline: v1.3.0/v1.3.1
(only minor releases) the branch to merge changes back to main: feat/release/v1.3.0
invalidate the CDN caches. This may become necessary if e.g. during measurement updating the measurements of a previous run are still in the cache

GCP

Navigate to Images tab of the "constellation-images" project
Search for the image versions "v1-3-0-gcp-sev-es-stable" and "v1-3-0-gcp-sev-snp-stable"
Select the images and press "DELETE"

Azure

Navigate to Azure compute galleries
Select "Constellation_CVM" (this is for confidential vms on AMD SEV SNP)
Select image definition "constellation"
Select "Versions" submenu and search for "1.3.0"
Press "Delete" button NEXT TO THE IMAGE VERSION TABLE. Do no delete the image definition.
Go back to "Azure compute galleries" page and select "Constellation" gallery (this is for trusted launch)
Select image definition "constellation"
Select "Versions" submenu and search for "1.3.0"
Press "Delete" button NEXT TO THE IMAGE VERSION TABLE. Do no delete the image definition.

AWS

Important: You need to repeat the following steps for every region supported by Constellation! Currently, this includes:

Frankfurt (eu-central-1)
Ireland (eu-west-1)
Paris (eu-west-3)
Ohio (us-east-2)
Mumbai (ap-south-1)

Navigate to AMI
Search for release version "constellation-v1.3.0" and select the AMIs for both variants ("constellation-v1.3.0-aws-sev-snp" and "constellation-v1.3.0-aws-nitro-tpm")
On the "Actions" button (top right) select "Deregister AMI"
Either follow the link on the deletion confirmation leading you to the Snapshots panel or navigate there yourself
Search for a snapshot by the same name "constellation-v1.3.0" and select it
On the "Actions" button (top right) select "Delete snapshot"

CDN cache invalidation

Navigate to the Cloudfront management console
Select the distribution for public resources. Current domain name: "cdn.confidential.cloud"
Click the "Invalidations" ribbon
Click "Create Invalidation" and enter a wildcard path "/*". You can also enter a more specific path if you know exactly which object to invalidate.
Wait for completion.

6.6 KiB Raw Blame History