如何在GitHub Actions中从hotfix/*分支构建Docker镜像

核心思路 #

在PR触发的Workflow中，需要明确指定checkout的分支为PR的源分支（即hotfix/*分支），而非默认的目标分支或合并后的虚拟分支。GitHub Actions提供的上下文变量github.head_ref可直接获取PR的源分支名称。

具体实现步骤 #

1. 配置Workflow触发条件
   限定Workflow仅在向main分支提交PR，且源分支以hotfix/开头时触发：

   name: Build Hotfix Docker Image
   on:
     pull_request:
       branches: [main]
       types: [opened, synchronize, reopened]
       branches:
         - 'hotfix/**' # 仅匹配hotfix/开头的源分支
   

2. 正确使用checkout动作
   使用actions/checkout@v3时，通过ref参数指定为${{ github.head_ref }}，确保checkout到PR的源分支：

   jobs:
     build-docker:
       runs-on: ubuntu-latest
       steps:
         - name: Checkout hotfix branch
           uses: actions/checkout@v3
           with:
             ref: ${{ github.head_ref }} # 关键：指定PR的源分支
             fetch-depth: 0 # 若需要完整Git历史（如生成版本号），设置为0
   
         - name: Build Docker image
           run: |
             # 示例：用分支名作为镜像标签
             BRANCH_NAME=$(echo ${{ github.head_ref }} | sed 's/\//-/g')
             docker build -t your-image-name:$BRANCH_NAME .
             # 可添加镜像推送等后续步骤
   

常见问题说明 #

• 若之前未指定ref，actions/checkout默认会checkout到PR合并后的虚拟提交，而非hotfix源分支，导致构建的是合并后的代码而非你需要的hotfix分支内容。
• github.head_ref仅在PR触发的Workflow中有效，直接分支推送触发的Workflow需用github.ref获取分支名。

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