This is documentation for the next version of Loki. For the latest stable release, go to the latest version.
Create Release Branch
A single release branch is created for every
minor release (not for patch releases). That release
branch is then used for all the Stable Releases, and all Patch Releases for that
minor versions of the Grafana Loki.
Before you begin
- Determine the VERSION_PREFIX.
- Announce about the upcoming release in
#loki-releasesinternal slack channel.
- Skip this announcement for a patch release. Create an issue to communicate beginning of the release process with the community. Example issue here.
Determine which commit should be used as a base for the release branch. Usually this is a
kxxweekly release branch.
Create and push the release branch from the selected base commit:
The name of the release branch should be
release-VERSION_PREFIX, such as
Branches are only made for VERSION_PREFIX; do not create branches for the full VERSION such as `release-v2.9.1` or `release-2.9.1`.
Don't create any other branches that are prefixed with `release` when creating PRs or those branches will collide with our automated release build publish rules.
Create a label to make backporting PRs to this branch easy.
The name of the label should be
backport release-VERSION_PREFIX, such as
Note there is space in the label name. The label name must follow this naming convention to trigger CI related jobs.