Docker Buildx 是一个 docker CLI 插件，其扩展了 docker 命令，支持 Moby BuildKit 提供的功能。提供了与 docker build 相同的用户体验，并增加了许多新功能。 BuildKit 是下一代的镜像构建组件，主要特点有很多，本文主要使用其可以编译多种系统架构的特性。

网址：https://github.com/moby/buildkit

需要注意的是，该功能仅适用于 Docker v19.03+ 版本。

本文将讲解如何使用 Buildx 构建多种系统架构的镜像。 在开始之前，已经默认你在 Linux 系统（各大发行版）下安装好了 64 位的 Docker。 在写本文时，Docker 最新版本号是 20.10.0。

$ docker version

Client: Docker Engine - Community
 Version:           20.10.0
 API version:       1.41
 Go version:        go1.13.15
 Git commit:        7287ab3
 Built:             Tue Dec  8 18:59:53 2020
 OS/Arch:           linux/amd64
 Context:           default
 Experimental:      true

Server: Docker Engine - Community
 Engine:
  Version:          20.10.0
  API version:      1.41 (minimum version 1.12)
  Go version:       go1.13.15
  Git commit:       eeddea2
  Built:            Tue Dec  8 18:57:44 2020
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.4.3
  GitCommit:        269548fa27e0089a8b8278fc4fc781d7f65a939b
 runc:
  Version:          1.0.0-rc92
  GitCommit:        ff819c7e9184c13b7c2607fe6c30ae19403a7aff
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0
ubuntu@VM-16-4-ubuntu:~$

1. 启用 Buildx ​

buildx 命令属于实验特性，因此首先需要开启该特性。 上面的查看 Docker 版本返回的内容中，如果出现Experimental: true字样就代表已经开启该特性了。 下面的这一步骤就可以省略。 编辑~/.docker/config.json 文件，新增如下内容（以下的演示适用于事先不存在 .docker 目录的情况下）

$ mkdir ~/.docker
$ cat > ~/.docker/config.json <<EOF
{
"experimental": "enabled"
}
EOF

Linux/macOS 下或者通过设置环境变量的方式（不推荐）：

$ export DOCKER_CLI_EXPERIMENTAL=enabled

2. 新建 builder 实例 ​

在 Docker 19.03+ 版本中可以使用 docker buildx build 命令使用 BuildKit 构建镜像。该命令支持 --platform 参数可以同时构建支持多种系统架构的 Docker 镜像，大大简化了构建步骤。

由于 Docker 默认的 builder 实例不支持同时指定多个 --platform ，我们必须首先创建一个新的 builder 实例。 $ docker buildx create --name mybuilder --driver docker-container

返回新的 builder 实例名，为「mybuilder」

mybuilder

使用新创建好的 builder 实例

$ docker buildx use mybuilder

查看已有的 builder 实例

$ docker buildx ls
NAME/NODE    DRIVER/ENDPOINT             STATUS   PLATFORMS
mybuilder *  docker-container
  mybuilder0 unix:///var/run/docker.sock inactive 
default      docker
  default    default                     running  linux/amd64, linux/386

Docker 在 linux/amd64 系统架构下是不支持 arm 架构镜像，因此我们可以运行一个新的容器（emulator）让其支持该特性，Docker 桌面版则无需进行此项设置。

• 方法一：

$ docker run --rm --privileged docker/binfmt:a7996909642ee92942dcd6cff44b9b95f08dad64

注：docker/binfmt 可以参考网址：https://hub.docker.com/r/docker/binfmt/tags 获取最新镜像

• 方法二（推荐）：

$ docker run --rm --privileged tonistiigi/binfmt --install all

去参考网址：https://hub.docker.com/r/tonistiigi/binfmt 获取最新镜像。目前（2021/09/02 更新）的 Qemu version: 6.0.0

3. 新建 Dockerfile 文件 ​

要想构建多种系统架构的镜像，还需要一个支持的 Dockerfile 文件。 以下是一个示例的 Dockerfile 文件。 参考链接：https://github.com/teddysun/across/blob/master/docker/kms/Dockerfile.architecture

该 Dockerfile 文件内容如下：

FROM --platform=$TARGETPLATFORM alpine:latest AS builder
WORKDIR /root
RUN apk add --no-cache git make build-base && \
    git clone --branch master --single-branch https://github.com/Wind4/vlmcsd.git && \
    cd vlmcsd/ && \
    make

FROM --platform=$TARGETPLATFORM alpine:latest
LABEL maintainer="Teddysun <i@teddysun.com>"

COPY --from=builder /root/vlmcsd/bin/vlmcsd /usr/bin/vlmcsd
EXPOSE 1688
CMD [ "vlmcsd", "-D", "-e" ]

$TARGETPLATFORM 是内置变量，由 --platform 参数来指定其值。 由于是基于 alpine 的镜像来制作的，而 alpine 是支持以下 7 种系统架构的，因此我们制作的镜像也就跟着支持这 7 种系统架构。

linux/amd64, linux/arm/v6, linux/arm/v7, linux/arm64, linux/386, linux/ppc64le, linux/s390x

更友好一点的架构名称如下：

amd64, arm32v6, arm32v7, arm64v8, i386, ppc64le, s390x

这里穿插一句吐槽。 简单统计了一下，ARM 的系统架构有如下各种简称：

arm64, armv8l, arm64v8, aarch64
arm, arm32, arm32v7, armv7, armv7l, armhf
arm32v6, armv6, armv6l, arm32v5, armv5,  armv5l, armel, aarch32

看完了是不是很想打人？ 而对比 Intel 和 AMD 的就简单多了：

x86, 386, i386, i686
x86_64, x64, amd64

4. 构建镜像 ​

先来本地构建一个。

git clone 刚才的示例 Dockerfile 文件，并进入其目录下

$ cd ~ && git clone https://github.com/teddysun/across.git && cd across/docker/kms/

在本地构建支持 7 种 platform 的镜像

$ docker buildx build --platform linux/amd64,linux/arm/v6,linux/arm/v7,linux/arm64,linux/ppc64le,linux/s390x,linux/386 -t teddysun/kms -o type=local,dest=.docker -f ./Dockerfile.architecture .

docker buildx build 的具体参数含义，参考下面的官方文档 https://docs.docker.com/engine/reference/commandline/buildx_build/

做完上面的那一步，实际上是把构建好的镜像放在了本地路径下。 此时我们再来查看一下已有的 builder 实例。

$ docker buildx ls
NAME/NODE    DRIVER/ENDPOINT             STATUS  PLATFORMS
mybuilder *  docker-container                    
  mybuilder0 unix:///var/run/docker.sock running linux/amd64, linux/arm64, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6
default      docker                              
  default    default                     running linux/amd64, linux/386

你会发现 mybuilder 下存在 8 种支持的架构（riscv64 目前还用不上，但是已经支持）。

此时查看一下 docker image 的运行情况，会发现存在一个名为 buildx_buildkit_mybuilder0 的容器在运行。 这是刚才在本地构建时，自动创建的，切记不要将其停止，也不要删除。

$ docker ps -as
CONTAINER ID        IMAGE                           COMMAND           CREATED             STATUS              PORTS             NAMES                        SIZE
be753fa16090        moby/buildkit:buildx-stable-1   "buildkitd"       15 minutes ago      Up 15 minutes                         buildx_buildkit_mybuilder0   0B (virtual 78.6MB)

再来构建一个多系统架构镜像，并将构建好的镜像推送到 Docker 仓库（也就是 hub.docker.com）。

在此操作之前，你需要事先注册一个账号（演示过程省略），并登录。 登录命令如下：

$ docker login

输入你的用户名和密码即可登录。

注意，以下演示的命令中 tag 的前面是我的用户名 finley，如果你想制作自己的镜像，请自行替换为你自己的用户名。 使用 --push 参数构建好的镜像推送到 Docker 仓库。 此时仍然是在刚才的 ~/across/docker/kms 目录下，文件 Dockerfile.architecture 是为多系统架构构建准备的。 命令如下：

$ docker buildx build --platform linux/386,linux/amd64,linux/arm/v6,linux/arm/v7,linux/arm64,linux/ppc64le,linux/s390x -t finley/kms --push -f ./Dockerfile.architecture .

命令执行成功后，你就会在 Docker Hub 看到你上传的镜像啦。

5. 写在最后 ​

在制作多系统架构的 Docker 镜像时，建议使用 CPU 比较强或者多核心的 VPS 来构建，否则会非常耗时。

参考 ​

https://github.com/moby/buildkit

https://teddysun.com/581.html

https://kubesphereio.com/post/docker-image-operation-guide-for-building-arm-x86-architecture/