Skip to content

Publishing a new kcp release


You currently need write access to the kcp-dev/kcp repository to perform these tasks.

You also need an available team member with approval permissions from

Create git tags

Prerequisite - make sure you have a GPG signing key


Create the tags

kcp has 2 go modules, and a unique tag is needed for each module every time we create a new release.

  1. git fetch from the main kcp repository (kcp-dev/kcp) to ensure you have the latest commits
  2. Tag the main module
  3. If your git remote for kcp-dev/kcp is named something other than upstream, change REF accordingly
  4. If you are creating a release from a release branch, change main in REF accordingly, or you can make REF a commit hash.

    git tag --sign --message "$TAG" "$TAG" "$REF"
  5. Tag the sdk module, following the same logic as above for REF and TAG

    git tag --sign --message "sdk/$TAG" "sdk/$TAG" "$REF"

    Push the tags

git push "$REMOTE" "$TAG" "sdk/$TAG"

If it's a new minor version

If this is the first release of a new minor version (e.g. the last release was v0.7.x, and you are releasing the first 0.8.x version), follow the following steps.

Otherwise, you can skip to Review/edit/publish the release in GitHub

Create a release branch

Set REMOTE, REF, and VERSION as appropriate.

git checkout -b "release-$VERSION" "$REF"
git push "$REMOTE" "release-$VERSION"

Review/edit/publish the release in GitHub

The goreleaser workflow automatically creates a draft GitHub release for each tag.

  1. Navigate to the draft release for the tag you just pushed. You'll be able to find it under the releases page.
  2. If the release notes have been pre-populated, delete them.
  3. For the "previous tag," select the most recent, appropriate tag as the starting point
  4. If this is a new minor release (e.g. v0.8.0), select the initial version of the previous minor release (e.g. v0.7.0)
  5. If this is a patch release (e.g. v0.8.7), select the previous patch release (e.g. v0.8.6)
  6. Click "Generate release notes"
  7. Publish the release


  1. Create an email addressed to and
  2. Subject: [release] <version> e.g. [release] v0.8.0
  3. In the body, include noteworthy changes
  4. Provide a link to the release in GitHub for the full release notes
  5. Post a message in the #kcp-dev Slack channel