首页/开发/CI/CD 与发布速查/多架构镜像(Manifest List / OCI Index)
构建与制品管理58 条

多架构镜像(Manifest List / OCI Index)

一个标签对应多架构镜像清单:拉取时按节点架构自动选择,ARM 与 x86 混合集群无需分开维护标签。

CI/CD 与发布速查开发更新于 2026-10-12
构件manifest list(Docker) / image index(OCI)聚合多个架构 manifest
构建docker buildx(--platform linux/amd64,linux/arm64)
查看docker manifest inspect / docker buildx imagetools inspect

buildx 构建推送

buildx 构建推送
docker buildx create --use --name multibuild
docker buildx build --platform linux/amd64,linux/arm64 \
  -t registry.example.com/app:1.8.0 --push .
跨架构构建用 QEMU 模拟会变慢:高频项目用原生架构 Runner 分别构建再合并清单。

易错点

  • 只构建 amd64 却部署到 ARM 节点:镜像不可运行,CI 增加平台矩阵或用 buildx
  • 清单合并前各架构标签不复用:遗漏某架构时拉取失败,发布检查覆盖全部目标平台

数据来源与参考

  • Docker Docs《Multi-platform images》
  • OCI Image Spec
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌