Skip to main content

Release Process

Create a tag

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}

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

Review the draft release

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.

Check the generated assets

Double check that the assets got created. There should be one zip file, one tgz file, and 12 yaml files.

Mark as pre-release if applicable

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.

Verify the container image

Before publishing you can check the Recent tagged image versions: "latest" should be some seconds old and the new version number.

Publish the release

Announce the release

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.

Login to ghcr

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