如何配置GitHub CI通过Release事件构建Docker镜像并打标签

现有配置核心问题 #

• 缺失Docker Hub身份认证步骤：没有登录Docker Hub的话，构建后没有权限推送镜像到个人仓库，会直接报权限错误
• 缺失多架构构建依赖：要构建linux/amd64、linux/arm64多平台镜像，必须先初始化QEMU模拟器和Docker Buildx构建工具，原配置没加这两步会导致跨架构构建失败
• 标签生成规则不全：docker/metadata-action的tags配置只写了release事件的ref规则，只会生成对应版本号标签，不会自动生成latest标签
• YAML语法错误：配置里省略号位置断开了步骤结构，缺少Docker meta步骤和Build push步骤之间的合法YAML层级，工作流根本无法被GitHub正常解析

修复后完整可用配置 #

name: ci

on:
  release:
    types:
      - published

jobs:
  docker:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3

      - name: 初始化QEMU（多架构构建依赖）
        uses: docker/setup-qemu-action@v2

      - name: 初始化Docker Buildx
        uses: docker/setup-buildx-action@v2

      - name: 登录Docker Hub
        uses: docker/login-action@v2
        with:
          username: ${{ secrets.DOCKER_HUB_USERNAME }}
          password: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}

      - name: Docker元数据生成
        id: meta
        uses: docker/metadata-action@v4
        with:
          images: |
            ${{ secrets.DOCKER_HUB_USERNAME }}/img
          tags: |
            type=ref,event=release
            # 触发release发布时强制打latest标签
            type=raw,value=latest,enable=${{ github.event_name == 'release' && github.event.action == 'published' }}

      - name: 构建并推送镜像
        uses: docker/build-push-action@v3
        with:
          context: .
          platforms: linux/amd64,linux/arm64
          push: true
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}

配置注意事项 #

• 提前在GitHub仓库的Secrets里配置两个变量：DOCKER_HUB_USERNAME填你的Docker Hub用户名，DOCKER_HUB_ACCESS_TOKEN填你在Docker Hub生成的有读写仓库权限的访问令牌
• 标签规则会在Release发布时自动生成两类标签：一类是和Release版本号一致的标签（比如v1.0.0），另一类是latest标签，始终指向最新发布的Release版本
• 补全了多架构构建需要的依赖步骤，跨平台镜像可以正常构建推送

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