如何用Docker Buildx构建支持多平台的应用镜像？
- 内容介绍
- 文章标签
- 相关推荐
本文共计957个文字，预计阅读时间需要4分钟。
在边缘节点使用Docker+Buildx构建多平台镜像的方法，包含但不限于构建ARM镜像。构建环境如下：
软件名称 | 版本--- | ---Ubuntu | 18.04.2LTSDocker | 20.10.16Ubuntu | 20.10.16Fedora | 33
安装构建环境：
1.安装Docker：
- Ubuntu: `sudo apt update && sudo apt install docker.io` - Fedora: `sudo dnf install docker`2. 安装Buildx插件： - `docker plugin install --grant-all-permissions gcr.io/buildx/cache`
3. 安装构建工具： - Ubuntu: `sudo apt install build-essential` - Fedora: `sudo dnf groupinstall Development Tools`
4. 创建工作目录： sh mkdir -p ~/buildx cd ~/buildx
5. 构建多平台镜像： sh docker buildx create --name mybuilder --use docker buildx use mybuilder docker buildx build --platform linux/amd64,linux/arm64 -t myimage:latest .
比较Ubuntu和Fedora构建环境：- Ubuntu和Fedora都支持Docker和Buildx，但版本略有差异。- 两个操作系统都提供了丰富的开发工具，满足构建需求。- 在Fedora上，需要安装Development Tools组才能提供所需工具。
写在前边记录一下前阵子在X86_64平台使用Docker Buildx构建多平台镜像的办法，包含但不限于构建ARM镜像。
构建环境启用BuildXUbuntu 和 Fedora 安装构建环境比较方便，没有内核版本低导致的一系列问题。如果想使用CentOS请参考其他文档。
Docker Buildx 是 Docker的CLI插件，来自于Moby BuildKit 。自从Docker 18.06 开始这个插件直接集成到了Docker build 中，直至成文之日，它仍处于Experimental状态，所以想使用它需要显式地开启它。
启用 Buildx 有两种方式：
-
临时激活：在执行构建命令前添加环境变量，如
DOCKER_BUILDKIT=1 docker buildx build -t 镜像:标签 --platform linux/arm64 . -
配置文件激活：
vim /etc/docker/daemon.json #添加配置 { "experimental": true }
qemu-user-static 用来模拟多平台环境，它依赖于binfmt-support，所以这两者都要安装。
sudo apt install -y qemu-user-static binfmt-support
通知Docker使用qemu
docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
创建Buildx构建容器
#创建构建容器
docker buildx create --name mybuilder
#buildx使用构建容器
docker buildx use mybuilder
#初始化构建容器
docker buildx inspect --bootstrap
当初始化成功，会拉下来moby/buildkit:buildx-stable-1的镜像，并启动构建容器。通过 docker ps 查看如下：
root@hz:~# docker ps
root@hz:~# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
ba6651e07ab0 moby/buildkit:buildx-stable-1 "buildkitd" 5 weeks ago Up 50 minutes buildx_buildkit_mybuilder0
调整Dockerfile接收平台相关参数
为确保构建容器能拉取到正确平台的基础镜像，可显式在FROM后指定平台参数
TARGETPLATFORM或BUILDPLATFORM，由buildx自动传递。
FROM --platform=$TARGETPLATFORM 基础镜像名:TAG
.... 其他内容
同时构建X86_64与ARM64镜像
构建并直接推送到指定仓库
docker buildx build -t 镜像仓库地址/镜像名:TAG --platform linux/amd64,linux/arm64 . --push
构建并导出到本地Docker images中
docker buildx build -t 镜像仓库地址/镜像名:TAG --platform linux/arm64 . --load
注意那个点，是构建上下文位置为当前目录的意思。另外导出到本地只能构建一个镜像，本地不支持同时导出manifest lists。
写在最后导出的镜像如果与当前运行环境平台不同，是无法直接启动的，可以导出(
docker save)传输到合适的平台上运行。
本文简易地创建了多平台镜像构建环境，如果对你有所帮助，欢迎点赞、评论、关注。
我是 Hellxz，过些日子再见！
本文共计957个文字，预计阅读时间需要4分钟。
在边缘节点使用Docker+Buildx构建多平台镜像的方法，包含但不限于构建ARM镜像。构建环境如下：
软件名称 | 版本--- | ---Ubuntu | 18.04.2LTSDocker | 20.10.16Ubuntu | 20.10.16Fedora | 33
安装构建环境：
1.安装Docker：
- Ubuntu: `sudo apt update && sudo apt install docker.io` - Fedora: `sudo dnf install docker`2. 安装Buildx插件： - `docker plugin install --grant-all-permissions gcr.io/buildx/cache`
3. 安装构建工具： - Ubuntu: `sudo apt install build-essential` - Fedora: `sudo dnf groupinstall Development Tools`
4. 创建工作目录： sh mkdir -p ~/buildx cd ~/buildx
5. 构建多平台镜像： sh docker buildx create --name mybuilder --use docker buildx use mybuilder docker buildx build --platform linux/amd64,linux/arm64 -t myimage:latest .
比较Ubuntu和Fedora构建环境：- Ubuntu和Fedora都支持Docker和Buildx，但版本略有差异。- 两个操作系统都提供了丰富的开发工具，满足构建需求。- 在Fedora上，需要安装Development Tools组才能提供所需工具。
写在前边记录一下前阵子在X86_64平台使用Docker Buildx构建多平台镜像的办法，包含但不限于构建ARM镜像。
构建环境启用BuildXUbuntu 和 Fedora 安装构建环境比较方便，没有内核版本低导致的一系列问题。如果想使用CentOS请参考其他文档。
Docker Buildx 是 Docker的CLI插件，来自于Moby BuildKit 。自从Docker 18.06 开始这个插件直接集成到了Docker build 中，直至成文之日，它仍处于Experimental状态，所以想使用它需要显式地开启它。
启用 Buildx 有两种方式：
-
临时激活：在执行构建命令前添加环境变量，如
DOCKER_BUILDKIT=1 docker buildx build -t 镜像:标签 --platform linux/arm64 . -
配置文件激活：
vim /etc/docker/daemon.json #添加配置 { "experimental": true }
qemu-user-static 用来模拟多平台环境，它依赖于binfmt-support，所以这两者都要安装。
sudo apt install -y qemu-user-static binfmt-support
通知Docker使用qemu
docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
创建Buildx构建容器
#创建构建容器
docker buildx create --name mybuilder
#buildx使用构建容器
docker buildx use mybuilder
#初始化构建容器
docker buildx inspect --bootstrap
当初始化成功，会拉下来moby/buildkit:buildx-stable-1的镜像，并启动构建容器。通过 docker ps 查看如下：
root@hz:~# docker ps
root@hz:~# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
ba6651e07ab0 moby/buildkit:buildx-stable-1 "buildkitd" 5 weeks ago Up 50 minutes buildx_buildkit_mybuilder0
调整Dockerfile接收平台相关参数
为确保构建容器能拉取到正确平台的基础镜像，可显式在FROM后指定平台参数
TARGETPLATFORM或BUILDPLATFORM，由buildx自动传递。
FROM --platform=$TARGETPLATFORM 基础镜像名:TAG
.... 其他内容
同时构建X86_64与ARM64镜像
构建并直接推送到指定仓库
docker buildx build -t 镜像仓库地址/镜像名:TAG --platform linux/amd64,linux/arm64 . --push
构建并导出到本地Docker images中
docker buildx build -t 镜像仓库地址/镜像名:TAG --platform linux/arm64 . --load
注意那个点，是构建上下文位置为当前目录的意思。另外导出到本地只能构建一个镜像，本地不支持同时导出manifest lists。
写在最后导出的镜像如果与当前运行环境平台不同，是无法直接启动的，可以导出(
docker save)传输到合适的平台上运行。
本文简易地创建了多平台镜像构建环境，如果对你有所帮助，欢迎点赞、评论、关注。
我是 Hellxz，过些日子再见！