grafana/scripts/build/ci-build/README.md

# grafana-build-container

These are the sources for the Docker image that we use for the Grafana build containers. The image source itself
is in Dockerfile, but there are supporting scripts such as the Makefile, for building images.

The image is based on Debian Buster, since we want an older Linux distribution (Buster has long-term support into 2024) to build binaries that are as portable as possible.

## Build/Publish Docker Image

In order to build and publish the Grafana build Docker image, execute the following:

```
# Download MacOSX10.15.sdk.tar.xz from our private GCS bucket into this directory
docker build -t grafana/build-container:<VERSION> --ulimit nofile=2048:2048 .
docker push grafana/build-container:<VERSION>
```

If you're running on a machine that has an ARM chip (Apple M1/M2, etc.), add `--platform linux/amd64` to the `docker build` command. It can take approximately four hours for an initial build to complete. Due to caching, subsequent builds take less time (~10 mins or so).
build: migrates the build container into the main repo. 2019-03-19 05:34:01 -05:00			`# grafana-build-container`

Build container: Base build image on Debian Stretch (#24967) * scripts/build/ci-build: Fix Makefile * scripts/build/ci-build: Base Docker image on Debian Stretch * scripts/build/ci-build: Modify Dockerfile for fewer RUN directives 2020-05-26 08:45:49 -05:00			`These are the sources for the Docker image that we use for the Grafana build containers. The image source itself`
			`is in Dockerfile, but there are supporting scripts such as the Makefile, for building images.`
build: migrates the build container into the main repo. 2019-03-19 05:34:01 -05:00
Chore: Upgrade Go to 1.19.1 (#54902) * WIP * Set public_suffix to a pre Ruby 2.6 version * we don't need to install python * Stretch->Buster * Bump versions in lib.star * Manually update linter Sort of messy, but the .mod-file need to contain all dependencies that use 1.16+ features, otherwise they're assumed to be compiled with -lang=go1.16 and cannot access generics et al. Bingo doesn't seem to understand that, but it's possible to manually update things to get Bingo happy. * undo reformatting * Various lint improvements * More from the linter * goimports -w ./pkg/ * Disable gocritic * Add/modify linter exceptions * lint + flatten nested list Go 1.19 doesn't support nested lists, and there wasn't an obvious workaround. https://go.dev/doc/comment#lists 2022-09-12 05:03:49 -05:00			`The image is based on Debian Buster, since we want an older Linux distribution (Buster has long-term support into 2024) to build binaries that are as portable as possible.`
build: migrates the build container into the main repo. 2019-03-19 05:34:01 -05:00
ci-build: Improve build-deploy script (#19653) Signed-off-by: Arve Knudsen <arve.knudsen@gmail.com> 2019-10-07 07:17:17 -05:00			`## Build/Publish Docker Image`
Prettier: Fix all markdown files and add markdown files to CI verify step (#39776) 2021-09-29 07:34:40 -05:00
ci-build: Improve build-deploy script (#19653) Signed-off-by: Arve Knudsen <arve.knudsen@gmail.com> 2019-10-07 07:17:17 -05:00			`In order to build and publish the Grafana build Docker image, execute the following:`
CI: Upgrade the build Docker image (#27337) * CI: Upgrade the build Docker image Signed-off-by: Arve Knudsen <arve.knudsen@gmail.com> * CI: Upgrade osxcross and Apple SDK Signed-off-by: Arve Knudsen <arve.knudsen@gmail.com> 2020-09-03 06:20:28 -05:00
			```
Chore: Upgrade golangci-lint (#27719) * Chore: Upgrade golangci-lint to latest * ci-build: Upgrade Node/Yarn Signed-off-by: Arve Knudsen <arve.knudsen@gmail.com> 2020-09-23 03:55:25 -05:00			`# Download MacOSX10.15.sdk.tar.xz from our private GCS bucket into this directory`
CI: Lint starlark files with `buildifier` (#59157) * Add verify-starlark build action that returns an error for starlark files with lint Relies on `buildifier` tool. Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Add verify_starlark_step to PR pipeline Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Manually fetch buildifier in curl_image until a new build_image is created Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Format with buildifier Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Remove all unused variables retaining one unused function Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Use snake_case for variable Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Replace deprecated dictionary concatenation with .update() method Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Start adding docstrings for all modules and functions Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Prefer os.WriteFile as ioutil.WriteFile has been deprecated since go 1.16 Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Attempt to document the behavior of the init_enterprise_step Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Document test_backend pipeline Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Document enterprise_downstream_step Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Document the pipeline utility function Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Document publish_images_step Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Document publish_images_steps Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Document enterprise2_pipelines function Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Add tags table for Starlark files. Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Document test_frontend Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Document windows function Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Add docstrings to verifystarlark functions Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Refactor error handling to be more clear and document complex behavior Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Split errors into execution errors and verification errors Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Document all other library functions Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Add local variables to TAGS Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Add blank line between all Args and Returns sections Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Fix new linting errors Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Lint new Starlark files Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Correct buildifier binary mv Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Document the need to set nofile ulimit to at least 2048 Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Update build-container to include buildifier Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Ensure buildifier binary is executable Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Fix valid content test Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Simply return execution error Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Only check files rather than fixing them Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Use updated build-container with executable buildifier Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Test that context cancellation stops execution Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Simplify error handling Return execution errors that short circuit WalkDir rather than separately tracking that error. Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Remove fetching of buildifier binary now that it is in the build-container Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Use build image in verify-starlark step Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Use semver tag The image is the same but uses a semver tag to make it clearer that this is a forward upgrade from the old version. Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Use node 18 image with buildifier Signed-off-by: Jack Baldry <jack.baldry@grafana.com> --------- Signed-off-by: Jack Baldry <jack.baldry@grafana.com> 2023-01-30 03:27:11 -06:00			`docker build -t grafana/build-container:<VERSION> --ulimit nofile=2048:2048 .`
Remove build-deploy.sh (#41586) 2021-11-11 02:23:12 -06:00			`docker push grafana/build-container:<VERSION>`
CI: Upgrade the build Docker image (#27337) * CI: Upgrade the build Docker image Signed-off-by: Arve Knudsen <arve.knudsen@gmail.com> * CI: Upgrade osxcross and Apple SDK Signed-off-by: Arve Knudsen <arve.knudsen@gmail.com> 2020-09-03 06:20:28 -05:00			```
Chore: Move to node 18 again (#62079) move to node 18 again 2023-01-26 04:19:39 -06:00
			If you're running on a machine that has an ARM chip (Apple M1/M2, etc.), add `--platform linux/amd64` to the `docker build` command. It can take approximately four hours for an initial build to complete. Due to caching, subsequent builds take less time (~10 mins or so).