如何拆分GitHub Actions容器镜像构建与推送步骤以使用构建输出设置标签

AI 小北

2026-10-7

解决方案

完全可以将构建和推送拆分为两个独立步骤，核心是利用Docker官方Action的load参数先将构建产物留存到本地Docker环境，处理完标签逻辑后再执行推送。

具体操作步骤

第一步：执行仅构建操作，将镜像加载到本地
调用docker/build-push-action时设置load: true，此时不会执行推送，构建完成的镜像会存在于GitHub Action运行环境的本地Docker daemon中，可直接操作。
```
- name: 构建本地镜像
  uses: docker/build-push-action@v5
  with:
    context: .
    load: true
    tags: temporary-build:latest
```

第二步：捕获版本号并设置环境变量
运行你自定义的版本提取逻辑，比如启动临时镜像获取内部版本号、解析构建日志等，将得到的版本号写入GitHub Action环境变量。

- name: 提取版本号
  run: |
    # 替换为你实际的版本提取逻辑，示例为从PowerShell镜像中获取版本号
    VERSION=$(docker run --rm temporary-build:latest pwsh -c "Write-Output `$PSVersionTable.PSVersion")
    echo "IMAGE_TAG=$VERSION" >> $GITHUB_ENV

第三步：给镜像打正式标签
用拿到的版本号给本地临时镜像重新打上目标registry的正式标签。

- name: 打正式镜像标签
  run: docker tag temporary-build:latest ghcr.io/pcgeek86/aws-powershell:${{ env.IMAGE_TAG }}

第四步：推送镜像到远端registry
再次调用docker/build-push-action，设置push: true并指定刚才打好的正式标签即可完成推送，此时会复用之前的构建层，不会重复构建。
```
- name: 推送镜像到GHCR
  uses: docker/build-push-action@v5
  with:
    context: .
    push: true
    tags: ghcr.io/pcgeek86/aws-powershell:${{ env.IMAGE_TAG }}
```