Menu
DocumentationGrafana Loki documentationCommunityMaintainingReleasing Grafana LokiCreate Release Branch
Open source
Create Release Branch
A single release branch is created for every major
or minor
release (not for patch releases). That release
branch is then used for all the Stable Releases, and all Patch Releases for that major
and minor
versions of the Grafana Loki.
Before you begin
- Determine the VERSION_PREFIX.
- Announce about the upcoming release in
#loki-releases
internal 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.
Steps
Determine which commit should be used as a base for the release branch. Usually this is a
kxx
weekly 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 asrelease-2.9.x
.Note
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`.
Note
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 asbackport release-2.9.x
.Note
Note there is space in the label name. The label name must follow this naming convention to trigger CI related jobs.
Was this page helpful?
Related resources from Grafana Labs
Additional helpful documentation, links, and articles:
60 min
Getting started with logging and Grafana Loki
See a demo of the updated features in Loki, and how to create metrics from logs and alert on your logs with powerful Prometheus-style alerting rules.
Video
Essential Grafana Loki configuration settings
This webinar focuses on Grafana Loki configuration including agents Promtail and Docker; the Loki server; and Loki storage for popular backends.
Video
Scaling and securing your logs with Grafana Loki
This webinar covers the challenges of scaling and securing logs, and how Grafana Enterprise Logs powered by Grafana Loki can help, cost-effectively.