GitHub Actions 怎么实现 Docker 镜像多架构构建-linux运维-PHP中文网

github actions 实现 docker 多架构构建的核心是 buildx 配合 qemu：先用 docker/setup-qemu-action 注册模拟器，再用 docker/setup-buildx-action 初始化多平台 builder，最后通过 docker/build-push-action 指定 platforms 构建并自动推送 manifest list。

github actions 怎么实现 docker 镜像多架构构建

GitHub Actions 实现 Docker 镜像多架构构建，核心是借助 Buildx（Docker 官方推荐的多平台构建工具）配合 QEMU 模拟器，在 GitHub 托管的 Linux runner 上交叉编译不同 CPU 架构（如 amd64、arm64、arm/v7 等）的镜像。它不依赖多个物理机器，一套 workflow 就能产出多架构 manifest list。

启用 Buildx 并配置多架构构建环境

GitHub 托管 runner 默认不启用 Buildx 的多架构支持，需显式安装 QEMU 和初始化 Buildx builder。关键步骤如下：

使用 docker/setup-qemu-action@v3 注册 QEMU 二进制文件，支持 arm64、arm/v7、ppc64le 等目标架构模拟
用 docker/setup-buildx-action@v3 创建并切换到一个支持多平台的 builder 实例（默认 builder 不支持 --platform）
确保构建时指定 --platform=linux/amd64,linux/arm64,linux/arm/v7（按需增删）

编写支持多架构的 docker.yml 工作流

以下是最简可用模板（替换 myorg/myapp 为你自己的镜像名）：

Git Factory

为每个编码任务配置并管理独立的 Git worktree，支持并行分支和清晰的 PR 工作流，避免合并冲突。

下载

name: Multi-arch Docker Build
on:
  push:
    branches: [main]
    tags: ['v*']
<p>jobs:
build-and-push:
runs-on: ubuntu-latest
steps:</p>

name: Checkout uses: actions/checkout@v4
name: Set up QEMU uses: docker/setup-qemu-action@v3
name: Set up Docker Buildx uses: docker/setup-buildx-action@v3
name: Login to Docker Hub uses: docker/login-action@v3 with: username: ${{ secrets.DOCKER_USERNAME }} password: ${{ secrets.DOCKER_PASSWORD }}
name: Build and push uses: docker/build-push-action@v5 with: context: . platforms: linux/amd64,linux/arm64,linux/arm/v7 push: true tags: | myorg/myapp:${{ github.sha }} myorg/myapp:latest myorg/myapp:${{ github.event.head_commit.tag_name }}

注意：docker/build-push-action@v5 内置对 Buildx + 多平台的支持，比手写 docker buildx build 命令更稳定、易维护。