容器与云原生 / 系统课时

构建多架构镜像

构建多架构镜像

本课解决 Docker 镜像在不同 CPU 架构环境中的部署问题。通过 Docker Buildx,可以一次构建支持 amd64、arm64 等平台的镜像,并理解模拟构建、原生构建和镜像清单索引之间的关系。

学习目标

  • 理解多架构镜像的组成方式。
  • 使用 buildx 创建并发布多平台镜像。
  • 区分 QEMU 模拟构建与原生节点构建方案。

理解多架构镜像模型

不同服务器可能使用不同 CPU 架构,例如传统云服务器常见 amd64,而部分边缘设备和云实例使用 arm64。如果镜像只包含单一架构,运行时可能出现平台不匹配错误。

Docker 通过 manifest list(镜像清单索引)解决这个问题。一个镜像标签可以关联多个平台镜像,客户端拉取时会根据当前环境自动选择对应版本。

多架构镜像清单索引结构图

使用 buildx 构建多平台镜像

Buildx 是 Docker 官方提供的扩展构建能力,支持 BuildKit 后端,并能够输出多平台镜像。创建构建器并查看支持的平台:

bash
docker buildx create --name multi-builder --use
docker buildx inspect --bootstrap

预期输出

text
Name: multi-builder
Platforms: linux/amd64, linux/arm64

构建多架构镜像:

bash
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t registry.example.com/demo/app:<TAG> \
  --push .

预期输出

text
[+] Building <TIME>
=> exporting manifest list
=> pushing registry.example.com/demo/app:<TAG>

--platform 指定目标架构,--push 会将多个平台结果和清单索引一起上传到镜像仓库。

选择模拟构建或原生构建

多架构构建主要有两种实现方式。使用 QEMU 模拟时,可以在单台机器上构建多个架构,但非本机架构的指令需要模拟执行,速度通常较慢,适合开发验证。

原生多节点构建则让不同架构机器分别完成对应构建任务,速度更快,更适合生产流水线。

方案 特点 适用场景
QEMU 模拟 配置简单,速度较慢 本地测试、小规模构建
原生节点 性能高,维护复杂 生产 CI/CD

验证多架构镜像

发布完成后,可以使用 imagetools 查看镜像清单:

bash
docker buildx imagetools inspect registry.example.com/demo/app:<TAG>

预期输出

text
Name: registry.example.com/demo/app:<TAG>
Manifests:
  Platform: linux/amd64
  Platform: linux/arm64

验证重点不是单个平台镜像是否存在,而是镜像标签是否正确关联多个架构版本。

常见构建问题

多架构构建失败通常来自以下原因:

  • 基础镜像没有目标架构支持,需要更换基础镜像版本。
  • 构建脚本依赖当前 CPU 指令,需要改造成跨平台逻辑。
  • 使用原生节点时,不同节点环境差异导致结果不一致。

构建时应固定依赖版本,并在 CI 环境中验证每个目标平台。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

构建多架构镜像

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通