How To Release¶
Release Branch¶
Always create a release branch for the releases, for example branch release-0.5
is for all the v0.5.x versions release. If it's a new release branch, simply create a branch from main
.
Release Steps¶
- Cherry-pick fixes to the release branch, skip this step if it's the first release in the branch.
- Run
make test
to make sure all test cases pass locally. - Push to remote branch, and make sure all the CI jobs pass.
- Run
make prepare-release VERSION=v{x.y.z}
to update version in manifests, wherex.y.x
is the expected new version. - Follow the output of last step, to confirm if all the changes are expected, and then run
make release VERSION=v{x.y.z}
. - Follow the output, push a new tag to the release branch, GitHub actions will automatically build and publish the new release, this will take around 10 minutes.
- Test the new release, make sure everything is running as expected, and then recreate a
stable
tag against the latest release.git tag -d stable git tag -a stable -m stable git push -d {your-remote} stable git push {your-remote} stable
- Find the new release tag, and edit the release notes.