diff options
| author |  Forest Johnson <forest.n.johnson@gmail.com> | 2022-11-22 11:17:41 +0000 |
|---|---|---|
| committer |  GitHub <noreply@github.com> | 2022-11-22 12:17:41 +0100 |
| commit | 6d43319fe19b19d2b89a8c877f8fb4674e9066af (patch) | |
| tree | ece3cd30662af0bc11746a17581d25398984d7cc | |
| parent | [chore] markdown: disable Smartypants rendering (#1111) (diff) | |
| download | gotosocial-6d43319fe19b19d2b89a8c877f8fb4674e9066af.tar.xz | |
[docs] Document non-buildx cross compilation for docker image (#1115)
* Enable / document cross compilation for docker image
* remove sudo
* explain whats up with BUILDPLATFORM/TARGETPLATFORM
| -rw-r--r-- | CONTRIBUTING.md | 13 | ||||
| -rw-r--r-- | Dockerfile | 6 |
2 files changed, 17 insertions, 2 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bee8f423b..84de73db2 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -330,7 +330,7 @@ If all goes according to plan, you should now have a number of multiple-architec ### Manually -If you prefer a simple approach to building a Docker container, with fewer dependencies, you can also just build in the following way: +If you prefer a simple approach to building a Docker container, with fewer dependencies (go-swagger, Node, Yarn), you can also just build in the following way: ```bash ./scripts/build.sh && docker buildx build -t superseriousbusiness/gotosocial:latest . @@ -338,7 +338,16 @@ If you prefer a simple approach to building a Docker container, with fewer depen The above command first builds the `gotosocial` binary, then invokes Docker buildx to build the container image. -You don't need to install go-swagger, Node, or Yarn to build Docker images this way. + +If you want to build a docker image for a different CPU architechture without setting up buildx (for example for ARMv7 aka 32-bit ARM), you can use: + +```bash +GOOS=linux GOARCH=arm ./scripts/build.sh && docker build --build-arg BUILDPLATFORM=linux/amd64 --build-arg TARGETPLATFORM=linux/arm/v7 -t superseriousbusiness/gotosocial:latest . +``` + +See also: [exhaustive list of GOOS and GOARCH values](https://gist.github.com/lizkes/975ab2d1b5f9d5fdee5d3fa665bcfde6) +And: [exhaustive list of possible values for docker's `--platform`](https://github.com/tonistiigi/binfmt/#build-test-image) + ## Financial Compensation diff --git a/Dockerfile b/Dockerfile index abb8c1947..9edc86851 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,6 +1,12 @@ # syntax=docker/dockerfile:1.3 # Dockerfile reference: https://docs.docker.com/engine/reference/builder/ +# When using buildx, these variables will be set by the tool: +# https://docs.docker.com/engine/reference/builder/#automatic-platform-args-in-the-global-scope +# However, declaring them as build arguments like this allows them to be set manually with `--build-arg` as well. +ARG BUILDPLATFORM +ARG TARGETPLATFORM + # stage 1: generate up-to-date swagger.yaml to put in the final container FROM --platform=${BUILDPLATFORM} quay.io/goswagger/swagger:v0.30.0 AS swagger |