DocumentationGrafana Loki documentationCommunityMaintainingReleasing Grafana LokiTag Release

Tag Release

A tag is required to create GitHub artifacts and as a prerequisite for publishing.

Before you begin

1. All required commits for the release should exist on the release branch. This includes functionality and documentation such as the release notes and CHANGELOG.md. All versions in the repo should have already been updated.

2. Make sure you are up to date on the release branch:

   Copy

   git checkout release-VERSION_PREFIX
   git fetch origin
   git pull origin

3. Determine the VERSION_PREFIX.

4. Follow the GitHub instructions to set up GPG for signature verification.

5. Optional: Configure git to always sign on commit or tag.

bash Copy

git config --global commit.gpgSign true
git config --global tag.gpgSign true

If you are on macOS or Linux and using an encrypted GPG key, gpg-agent or gpg may be unable to prompt you for your private key passphrase. This will be denoted by an error when creating a commit or tag. To circumvent the error, add the following into your ~/.bash_profile, ~/.bashrc or ~/.zshrc, depending on which shell you are using.

Copy

export GPG_TTY=$(tty)

Steps

1. Tag the release:

   Example commands:

   Copy

   RELEASE="v$VERSION" # e.g: v2.9.0
   git tag -s $RELEASE -m "tagging release $RELEASE"
   git push origin $RELEASE

2. After a tag has been pushed, GitHub CI will create release assets and open a release draft for every pushed tag.

   • This will take ~10-20 minutes.
   • You can monitor this by viewing the drone build on the commit for the release tag.
   • It also creates a PR to update the Helm charts. Example PR. Review and merge it.