loki/docs/sources/maintaining/release-loki-build-image.md

---
title: Releasing Loki Build Image
---
# Releasing `loki-build-image`

The [`loki-build-image`](https://github.com/grafana/loki/tree/master/loki-build-image) is the Docker image used to run tests and build Grafana Loki binaries in CI.

The image is released with any change to `./loki-build-image` on `main`.

## How To Use a New Release

1. Update the version tag of the `loki-build-image` pipeline defined in `.drone/drone.jsonnet` (search for `pipeline('loki-build-image')`).
1. Merge change into `main` and wait for the release.
1. Update `BUILD_IMAGE_VERSION` in the `Makefile`.
1. Update the image version in all the other places it exists
    1. Dockerfiles in `cmd` directory
    1. .circleci/config.yml
1. Run `make drone BUILD_IN_CONTAINER=false` to rebuild the drone yml file with the new image version (the image version in the Makefile is used)
2. Merge change into `main`.
Sync docs to website (#2378) * update docs location * add workflow * update docs content * update content * cleanup 5 years ago			`---`
			`title: Releasing Loki Build Image`
			`---`
Fix compiled logproto protobuf (#1183) * Enforce recompile of protobuf sources on 'make check-generated-files' * Pinned version of protobuf in loki-build-image * Pinned version of goyacc in loki-build-image * Added 'make build-image-push' to Makefile * Documented how to release loki-build-image 6 years ago			# Releasing `loki-build-image`

Docs: correctly represent product name (#4416) The product name is Grafana Loki. The first use of the product name on each web page should be the full product name. After that, within each page, it is fine to use just Loki. This PR also set up some frontmatter with weights where it was missing on a few files, and correct where "Loki" was not capitalized. 4 years ago			The [`loki-build-image`](https://github.com/grafana/loki/tree/master/loki-build-image) is the Docker image used to run tests and build Grafana Loki binaries in CI.
Fix compiled logproto protobuf (#1183) * Enforce recompile of protobuf sources on 'make check-generated-files' * Pinned version of protobuf in loki-build-image * Pinned version of goyacc in loki-build-image * Added 'make build-image-push' to Makefile * Documented how to release loki-build-image 6 years ago
Build and publish build image. (#5322) 4 years ago			The image is released with any change to `./loki-build-image` on `main`.
Fix compiled logproto protobuf (#1183) * Enforce recompile of protobuf sources on 'make check-generated-files' * Pinned version of protobuf in loki-build-image * Pinned version of goyacc in loki-build-image * Added 'make build-image-push' to Makefile * Documented how to release loki-build-image 6 years ago
Build and publish build image. (#5322) 4 years ago			`## How To Use a New Release`

			1. Update the version tag of the `loki-build-image` pipeline defined in `.drone/drone.jsonnet` (search for `pipeline('loki-build-image')`).
			1. Merge change into `main` and wait for the release.
			1. Update `BUILD_IMAGE_VERSION` in the `Makefile`.
Adding `zip` to the build image (#1364) Adding `drone` to the build image and updating the make target to run the drone command in the build image Re-adding `GO111MODULE=on` to the dependency import as it is still required and was removed in error. (Also updated the comment a little to reflect why it is still needed) 6 years ago			`1. Update the image version in all the other places it exists`
			1. Dockerfiles in `cmd` directory
Spelling (#2014) * spelling: access * spelling: actual * spelling: asynchronously * spelling: circleci * spelling: circle * spelling: cognitive * spelling: comment * spelling: computation * spelling: correct * spelling: daemon * spelling: elliott * spelling: enabled * spelling: encbuf * spelling: extracted * spelling: explicitly * spelling: independent * spelling: languages * spelling: loose * spelling: message * spelling: metrics * spelling: mismatch * spelling: nonexistent * spelling: output * spelling: pipeline * spelling: pipe line * spelling: position * spelling: prepend * spelling: query * spelling: receive * spelling: received * spelling: reducible * spelling: registry * spelling: response * spelling: retryable * spelling: scanning * spelling: sourced * spelling: supported * spelling: template * spelling: timeout * spelling: unsupported * spelling: adapter * spelling: deferring * spelling: expirable 6 years ago			`1. .circleci/config.yml`
Build and publish build image. (#5322) 4 years ago			1. Run `make drone BUILD_IN_CONTAINER=false` to rebuild the drone yml file with the new image version (the image version in the Makefile is used)
			2. Merge change into `main`.