Skip to content

Latest commit

 

History

History
45 lines (32 loc) · 1.43 KB

RELEASE.md

File metadata and controls

45 lines (32 loc) · 1.43 KB

Release Guide

We use GoReleaser and GitHub workflows for automating the release process. Follow the instructions below for creating a new release.

  1. Ensure local master branch is up to date with origin/master:

    git fetch --tags && git pull --tags
  2. Ensure all checks are passing:

    make check
  3. Update the CHANGELOG. Make sure that the format is consistent especially the version heading. We follow semantic versioning for our releases.

    You can check if the file format is correct by running release-info for the new version:

    go install github.com/sapcc/go-bits/tools/release-info@latest
    release-info CHANGELOG.md X.Y.Z

    where X.Y.Z is the version that you are planning to release.

  4. Commit the updated changelog with message: Release <version>

  5. Create and push a new Git tag:

    git tag vX.Y.Z
    git push --tags

    [!IMPORTANT] Tags are prefixed with v and the GitHub release workflow is triggered for tags that match the v[0-9]+.[0-9]+.[0-9]+ gh-pattern.