使用 buildx 构建多种系统架构支持的 Docker 镜像
在之前的版本中构建多种系统架构支持的 Docker 镜像,要想使用统一的名字必须使用 $ docker manifest 命令。
在 Docker 19.03+ 版本中可以使用 $ docker buildx build 命令使用 BuildKit 构建镜像。该命令支持 --platform 参数可以同时构建支持多种系统架构的 Docker 镜像,大大简化了构建步骤。

新建 builder 实例

Docker for Linux 不支持构建 arm 架构镜像,我们可以运行一个新的容器让其支持该特性,Docker 桌面版无需进行此项设置。
1
$ docker run --rm --privileged tonistiigi/binfmt:latest --install all
Copied!
由于 Docker 默认的 builder 实例不支持同时指定多个 --platform,我们必须首先创建一个新的 builder 实例。同时由于国内拉取镜像较缓慢,我们可以使用配置了 镜像加速地址dockerpracticesig/buildkit:master 镜像替换官方镜像。
如果你有私有的镜像加速器,可以基于 https://github.com/docker-practice/buildx 构建自己的 buildkit 镜像并使用它。
1
# 适用于国内环境
2
$ docker buildx create --use --name=mybuilder-cn --driver docker-container --driver-opt image=dockerpracticesig/buildkit:master
3
4
# 适用于腾讯云环境(腾讯云主机、coding.net 持续集成)
5
$ docker buildx create --use --name=mybuilder-cn --driver docker-container --driver-opt image=dockerpracticesig/buildkit:master-tencent
6
7
# $ docker buildx create --name mybuilder --driver docker-container
8
9
$ docker buildx use mybuilder
Copied!

构建镜像

新建 Dockerfile 文件。
1
FROM --platform=$TARGETPLATFORM alpine
2
3
RUN uname -a > /os.txt
4
5
CMD cat /os.txt
Copied!
使用 $ docker buildx build 命令构建镜像,注意将 myusername 替换为自己的 Docker Hub 用户名。
--push 参数表示将构建好的镜像推送到 Docker 仓库。
1
$ docker buildx build --platform linux/arm,linux/arm64,linux/amd64 -t myusername/hello . --push
2
3
# 查看镜像信息
4
$ docker buildx imagetools inspect myusername/hello
Copied!
在不同架构运行该镜像,可以得到该架构的信息。
1
# arm
2
$ docker run -it --rm myusername/hello
3
Linux buildkitsandbox 4.9.125-linuxkit #1 SMP Fri Sep 7 08:20:28 UTC 2018 armv7l Linux
4
5
# arm64
6
$ docker run -it --rm myusername/hello
7
Linux buildkitsandbox 4.9.125-linuxkit #1 SMP Fri Sep 7 08:20:28 UTC 2018 aarch64 Linux
8
9
# amd64
10
$ docker run -it --rm myusername/hello
11
Linux buildkitsandbox 4.9.125-linuxkit #1 SMP Fri Sep 7 08:20:28 UTC 2018 x86_64 Linux
Copied!

架构相关变量

Dockerfile 支持如下架构相关的变量
TARGETPLATFORM
构建镜像的目标平台,例如 linux/amd64, linux/arm/v7, windows/amd64
TARGETOS
TARGETPLATFORM 的 OS 类型,例如 linux, windows
TARGETARCH
TARGETPLATFORM 的架构类型,例如 amd64, arm
TARGETVARIANT
TARGETPLATFORM 的变种,该变量可能为空,例如 v7
BUILDPLATFORM
构建镜像主机平台,例如 linux/amd64
BUILDOS
BUILDPLATFORM 的 OS 类型,例如 linux
BUILDARCH
BUILDPLATFORM 的架构类型,例如 amd64
BUILDVARIANT
BUILDPLATFORM 的变种,该变量可能为空,例如 v7

使用举例

例如我们要构建支持 linux/arm/v7linux/amd64 两种架构的镜像。假设已经生成了两个平台对应的二进制文件:
  • bin/dist-linux-arm
  • bin/dist-linux-amd64
那么 Dockerfile 可以这样书写:
1
FROM scratch
2
3
# 使用变量必须申明
4
ARG TARGETOS
5
6
ARG TARGETARCH
7
8
COPY bin/dist-${TARGETOS}-${TARGETARCH} /dist
9
10
ENTRYPOINT ["dist"]
Copied!