如何使用Github Actions配合多份Dockerfile构建多架构镜像

完全可以实现，不需要强制所有架构共用同一份Dockerfile。核心逻辑是先为每个架构单独调用对应Dockerfile构建单架构镜像，再把这些镜像合并为统一的多架构镜像清单（manifest list）推送至镜像仓库即可，具体操作流程如下：

1. 配置多架构构建基础环境 #

首先需要在Workflow中初始化QEMU和Docker Buildx组件，这是支持多架构镜像构建的基础依赖：

- name: Set up QEMU
  uses: docker/setup-qemu-action@v3

- name: Set up Docker Buildx
  uses: docker/setup-buildx-action@v3

- name: Login to image registry
  uses: docker/login-action@v3
  with:
    username: ${{ secrets.REGISTRY_USERNAME }}
    password: ${{ secrets.REGISTRY_TOKEN }}

2. 分架构构建并推送临时镜像 #

你可以为每个架构的镜像单独打上带架构标识的临时标签，分别指定对应架构的Dockerfile完成构建推送。假设你项目中存在Dockerfile.amd64、Dockerfile.arm64两个独立架构的Dockerfile，参考配置如下：

- name: Build amd64 image
  uses: docker/build-push-action@v5
  with:
    context: .
    file: ./Dockerfile.amd64
    platforms: linux/amd64
    push: true
    tags: your-account/your-image:amd64-temp

- name: Build arm64 image
  uses: docker/build-push-action@v5
  with:
    context: .
    file: ./Dockerfile.arm64
    platforms: linux/arm64
    push: true
    tags: your-account/your-image:arm64-temp

如果你的架构数量较多，可以用GitHub Actions的matrix矩阵配置简化步骤，避免重复编写构建配置。

3. 合并多架构镜像并推送正式标签 #

使用docker buildx imagetools create命令将多个临时单架构镜像合并为同一个多架构镜像，推送正式标签到镜像仓库：

- name: Merge multi-arch manifest
  run: |
    docker buildx imagetools create \
      --tag your-account/your-image:latest \
      your-account/your-image:amd64-temp \
      your-account/your-image:arm64-temp

构建完成后你可以根据需要删除临时标签的镜像，避免占用镜像仓库的存储空间。该方案适配所有多架构独立Dockerfile的场景，比单Dockerfile的跨架构适配灵活性更高，非常适合不同架构底层逻辑差异较大的项目。

内容的提问来源于stack exchange，提问作者M. Buil