Docker多架构镜像构建全过程
随着云原生架构的普及以及ARM服务器和Apple Silicon（M系列芯片）的崛起，开发人员经常需要构建同时支持多种CPU架构（如AMD64和ARM64）的Docker镜像。本文将详细介绍如何使用Docker构建多架构镜像的全过程，帮助您实现一次构建，到处运行。
一、 核心原理
多架构镜像的核心在于Manifest List（清单列表）。当用户拉取镜像时，Docker客户端会根据当前宿主机的CPU架构，自动从Manifest List中选择匹配的镜像版本进行下载。
构建多架构镜像目前主要依赖两个核心工具：
1. Buildx：Docker官方提供的扩展构建工具，支持使用BuildKit并行构建多架构镜像。
2. QEMU：硬件模拟器，用于在AMD64主机上模拟运行并构建ARM64架构的镜像。
二、 环境准备
确保您的Docker版本在19.03及以上，并开启实验性功能。接下来需要创建Buildx构建器并安装QEMU模拟支持。
# 1. 创建并启用新的Buildx构建器 docker buildx create --name multiarch_builder --use # 2. 启动并检查构建器状态 docker buildx inspect --bootstrap # 3. 安装QEMU模拟器（需特权模式运行），支持跨平台构建 docker run --privileged --rm tonistiigi/binfmt --install all
三、 编写Dockerfile
为了适配多架构，Dockerfile中应避免硬编码架构相关的依赖。Docker Buildx在构建时会自动注入TARGETARCH等内置变量，我们可以利用这些变量动态下载对应架构的二进制文件。
# syntax=docker/dockerfile:1 FROM golang:1.21 AS builder WORKDIR /app COPY . . # 利用 TARGETARCH 变量动态编译对应架构的Go程序 RUN CGO_ENABLED=0 GOOS=linux GOARCH=$TARGETARCH go build -o myapp FROM alpine:latest WORKDIR /root/ # 基础镜像 alpine 会自动根据构建平台拉取对应架构的版本 COPY --from=builder /app/myapp . CMD ["./myapp"]
四、 构建并推送多架构镜像
使用Buildx可以直接一次性构建并推送多架构镜像到远程仓库。请注意，本地Docker的镜像存储格式不支持同时加载多个架构的镜像到本地列表，因此多架构构建通常需要配合--push参数直接推送到Registry。
# 构建并推送 AMD64 和 ARM64 架构的镜像到远程仓库 docker buildx build --platform linux/amd64,linux/arm64 -t www.ipipp.com/myrepo/myapp:latest --push .
五、 使用Docker Manifest合并已有镜像
如果您已经在不同架构的物理机上分别构建了单架构镜像，可以使用Docker Manifest将它们合并为一个多架构索引。
# 分别推送不同架构的镜像到远程仓库 docker push www.ipipp.com/myrepo/myapp:amd64 docker push www.ipipp.com/myrepo/myapp:arm64 # 创建Manifest List，将两个单架构镜像关联起来 docker manifest create www.ipipp.com/myrepo/myapp:latest www.ipipp.com/myrepo/myapp:amd64 www.ipipp.com/myrepo/myapp:arm64 # 推送Manifest List到远程仓库 docker manifest push www.ipipp.com/myrepo/myapp:latest
六、 验证多架构镜像
构建并推送完成后，可以使用Buildx的imagetools工具查看远程仓库中镜像的架构清单，验证是否构建成功。
# 查看远程仓库镜像的详细架构信息 docker buildx imagetools inspect www.ipipp.com/myrepo/myapp:latest
如果输出结果中同时包含了linux/amd64和linux/arm64的相关信息，则说明多架构镜像构建成功。此时，不同架构的机器在执行docker pull www.ipipp.com/myrepo/myapp:latest时，都会自动拉取并运行适配当前系统的镜像版本。