Docker Buildx 是一个 Docker CLI 插件，其扩展了 Docker 命令，支持 Moby BuildKit 提供的功能。提供了与 Docker Build 相同的用户体验，并增加了许多新功能。
BuildKit 是下一代的镜像构建组件，主要特点有很多，本文主要使用其可以编译多种系统架构的特性。
网址：https://github.com/moby/buildkit
需要注意的是，该功能仅适用于 Docker v19.03 版本。
本文将讲解如何使用 Buildx 构建多种系统架构的镜像。
在开始之前，已经默认你在 Linux 系统（各大发行版）下安装好了 64 位的 Docker。
在写本文时，Docker 最新版本号是 19.03.13。
代码语言：javascript复制$ docker version
Client: Docker Engine - Community
Version: 19.03.13
API version: 1.40
Go version: go1.13.15
Git commit: 4484c46d9d
Built: Wed Sep 16 17:03:45 2020
OS/Arch: linux/amd64
Experimental: true
Server: Docker Engine - Community
Engine:
Version: 19.03.13
API version: 1.40 (minimum version 1.12)
Go version: go1.13.15
Git commit: 4484c46d9d
Built: Wed Sep 16 17:02:21 2020
OS/Arch: linux/amd64
Experimental: false
containerd:
Version: 1.3.7
GitCommit: 8fba4e9a7d01810a393d5d25a3621dc101981175
runc:
Version: 1.0.0-rc10
GitCommit: dc9208a3303feef5b3839f4323d9beb36df0a9dd
docker-init:
Version: 0.18.0
GitCommit: fec3683
1. 启用 Buildx
buildx 命令属于实验特性，因此首先需要开启该特性。
上面的查看 Docker 版本返回的内容中，如果出现 Experimental: true 字样就代表已经开启该特性了。下面的这一步骤就可以省略。
编辑 ~/.docker/config.json 文件，新增如下内容（以下的演示适用于事先不存在 .docker 目录的情况下）
$ mkdir ~/.docker
$ cat > ~/.docker/config.json <<EOF
{
"experimental": "enabled"
}
EOF
Linux/macOS 下可以通过设置环境变量的方式启用（不推荐）：
代码语言：javascript复制$ 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」
代码语言：javascript复制mybuilder
使用新创建好的 Builder 实例
代码语言：javascript复制$ docker buildx use mybuilder
查看已有的 Builder 实例
代码语言：javascript复制$ 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/04/20 更新）的
Qemu version: 5.0.0
3. 新建 Dockerfile 文件
要想构建多种系统架构的镜像，还需要一个支持的 Dockerfile 文件。
以下是一个示例的 Dockerfile 文件。
参考链接：https://github.com/teddysun/across/blob/master/docker/kms/Dockerfile.architecture
该 Dockerfile 文件内容如下：
代码语言：javascript复制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 种系统架构。
代码语言：javascript复制linux/amd64, linux/arm/v6, linux/arm/v7, linux/arm64, linux/386, linux/ppc64le, linux/s390x
更友好一点的架构名称如下：
代码语言：javascript复制amd64, arm32v6, arm32v7, arm64v8, i386, ppc64le, s390x
这里穿插一句吐槽。简单统计了一下，ARM 的系统架构有如下各种简称：
代码语言：javascript复制arm64, armv8l, arm64v8, aarch64
arm, arm32, arm32v7, armv7, armv7l, armhf
arm32v6, armv6, armv6l, arm32v5, armv5, armv5l, armel, aarch32
看完了是不是很想打人？
而对比 Intel 和 AMD 的就简单多了：
代码语言：javascript复制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 的镜像
代码语言：javascript复制$ 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 实例。
代码语言：javascript复制$ 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 的容器在运行。
这是刚才在本地构建时，自动创建的，切记不要将其停止，也不要删除。
代码语言：javascript复制$ 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）。
在此操作之前，你需要事先注册一个账号（演示过程省略），并登录。登录命令如下：
代码语言：javascript复制$ docker login
输入你的用户名和密码即可登录。
注意，以下演示的命令中 tag 的前面是我的用户名 teddysun，如果你想制作自己的镜像，请自行替换为你自己的用户名。
使用 --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 teddysun/kms --push -f ./Dockerfile.architecture .
命令执行成功后，你就会在 Docker Hub 看到你上传的镜像啦。示例图如下：
5. 写在最后
在制作多系统架构的 Docker 镜像时，建议使用 CPU 比较强或者多核心的 VPS 来构建，否则会非常耗时。
本文转载自：「秋水逸冰」，原文：https://teddysun.com/581.html ，版权归原作者所有。欢迎投稿，投稿邮箱: editor@hi-linux.com。
