| Tom Rini | 04549e9 | 2021-03-15 13:19:01 -0400 | [diff] [blame] | 1 | GitLab CI / U-Boot runner container |
| 2 | =================================== |
| 3 | |
| Simon Glass | 7aafac0 | 2024-11-27 11:17:26 -0600 | [diff] [blame^] | 4 | In order to have a reproducible and portable build environment for CI we use a container for building in. This means that developers can also reproduce the CI environment, to a large degree at least, locally. This file is located in the tools/docker directory. |
| 5 | |
| 6 | The docker image supports both amd64 and arm64. Ensure that the |
| 7 | 'docker-buildx' Debian package is installed (or the equivalent on another |
| 8 | distribution). |
| 9 | |
| 10 | You will need a multi-platform container, otherwise this error is shown:: |
| 11 | |
| 12 | ERROR: Multi-platform build is not supported for the docker driver. |
| 13 | Switch to a different driver, or turn on the containerd image store, and try again. |
| 14 | |
| 15 | You can add one with:: |
| 16 | |
| 17 | sudo docker buildx create --name multiarch --driver docker-container --use |
| 18 | |
| 19 | Building is supported on both amd64 (i.e. 64-bit x86) and arm64 machines. While |
| 20 | both amd64 and arm64 happen in parallel, the non-native part will take |
| 21 | considerably longer as it must use QEMU to emulate the foreign code. |
| 22 | |
| 23 | To build the image yourself:: |
| Tom Rini | 04549e9 | 2021-03-15 13:19:01 -0400 | [diff] [blame] | 24 | |
| 25 | .. code-block:: bash |
| 26 | |
| Simon Glass | 7aafac0 | 2024-11-27 11:17:26 -0600 | [diff] [blame^] | 27 | sudo docker buildx build --platform linux/arm64/v8,linux/amd64 -t your-namespace:your-tag . |
| Tom Rini | 04549e9 | 2021-03-15 13:19:01 -0400 | [diff] [blame] | 28 | |
| 29 | Or to use an existing container |
| 30 | |
| 31 | .. code-block:: bash |
| 32 | |
| Mattijs Korpershoek | 7fe617c | 2024-04-05 08:16:19 +0200 | [diff] [blame] | 33 | sudo docker pull trini/u-boot-gitlab-ci-runner:jammy-20240227-14Mar2024 |