Release Process

Create a tag

1. Create an annotated tag

   • git switch main
   • git pull
   • Have a look at the current (old) version: Github Releases
   • export RELEASE_TAG=<the tag of the release to be cut> (eg. export RELEASE_TAG=v1.0.1 )
   • git tag -a ${RELEASE_TAG} -m ${RELEASE_TAG}

2. Push the tag to the GitHub repository.

   note

   origin should be the name of the remote pointing to github.com/syself/cluster-api-provider-hetzner

   • git push origin ${RELEASE_TAG}
   • This will automatically trigger a Github Action to create a draft release (this will take roughly 6 minutes).

Release in GitHub

1. Review the draft release on GitHub: Releases. Use the pencil-icon to edit the draft release. Then use the button "Generate release notes". Pay close attention to the ## :question: Sort these by hand section, as it contains items that need to be manually sorted. Feel free to move less important PRs, like version upgrades (from renovate bot), to the bottom.
2. Double checkt that the assets got created. There should be one zip file, one tgz file, and 12 yaml files.
3. If it is pre-release, activate the corresponding check at the bottom of the page. And add :rotating_light: This is a RELEASE CANDIDATE. If you find any bugs, file an [issue](https://github.com/syself/cluster-api-provider-hetzner/issues/new). at the top of the release notes.
4. Before publishing you can check the Recent tagged image versions: "latest" should be some seconds old and the new version number.
5. Publish the release
6. Write to the corresponding channels: "FYI: .... was released, (add hyperlink). A big "thank you" to all contributors!"

Done 🥳

Manual creation of images

This is only needed if you want to manually release images.

1. Login to ghcr
2. Execute make release-image

Versioning

See the versioning documentation for more information.

Permissions

Releasing requires a particular set of permissions.

• Tag push access to the GitHub repository
• GitHub Release creation access