基于多主机构建多平台Docker镜像的可行方案咨询

完全可以通过Docker的manifest命令手动创建多平台镜像清单（Manifest List），这就是你提到的“单一多平台镜像实体”，而非松散关联的两个镜像。以下是具体步骤：

步骤1：两台主机准备工作 #

• 确保两台机器都已登录目标镜像仓库（比如Docker Hub或私有仓库）：

  docker login
  

• 确保Docker版本支持manifest命令（Docker 18.06+已默认支持，若未启用可在~/.docker/config.json中添加"experimental": "enabled"）。

步骤2：在x86_64 Linux主机上构建并推送架构专属镜像 #

• 构建x86_64架构的镜像，打带架构标识的标签：

  docker build -t your-repo/your-image:x86_64 .
  

• 推送到镜像仓库：

  docker push your-repo/your-image:x86_64
  

步骤3：在arm64 Mac主机上构建并推送架构专属镜像 #

• 构建arm64架构的镜像，打带架构标识的标签：

  docker build -t your-repo/your-image:arm64 .
  

  注：如果需要基于x86_64版本的镜像增量构建，拉取时指定标签即可：docker pull your-repo/your-image:x86_64，再调整Dockerfile完成构建。

• 推送到镜像仓库：

  docker push your-repo/your-image:arm64
  

步骤4：创建并推送多平台镜像清单 #

在任意一台主机上执行以下操作：

• 创建Manifest List，将两个架构的镜像关联到统一标签（比如latest）：

  docker manifest create your-repo/your-image:latest \
    your-repo/your-image:x86_64 \
    your-repo/your-image:arm64
  

• 为每个架构镜像补充平台信息，确保Docker能正确识别：

  docker manifest annotate your-repo/your-image:latest \
    your-repo/your-image:x86_64 --os linux --arch amd64
  docker manifest annotate your-repo/your-image:latest \
    your-repo/your-image:arm64 --os darwin --arch arm64
  

• 推送Manifest List到仓库：

  docker manifest push your-repo/your-image:latest
  

验证效果 #

• 拉取统一标签的镜像时，Docker会自动匹配对应架构的版本：

  # 在x86_64机器上
  docker pull your-repo/your-image:latest
  docker inspect your-repo/your-image:latest | grep Architecture
  # 输出应为amd64
  
  # 在arm64 Mac上
  docker pull your-repo/your-image:latest
  docker inspect your-repo/your-image:latest | grep Architecture
  # 输出应为arm64
  

这个方法完全不需要QEMU模拟，也不用云构建，纯本地两台机器即可完成，最终生成的Manifest List就是Docker官方文档中提到的“单一多平台镜像实体”，Docker运行时会自动选择匹配的架构镜像。

内容的提问来源于stack exchange，提问作者dgorur