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.


    origin should be the name of the remote pointing to

    • 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. 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]( at the top of the release notes.
  3. Before publishing you can check the Recent tagged image versions : "latest" should be some seconds old and the new version number.
  4. Publish the release
  5. 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


See the versioning documentation for more information.


Releasing requires a particular set of permissions.

  • Tag push access to the GitHub repository
  • GitHub Release creation access
Reference of Tilt
Updating Kubernetes Version