仅main分支存放工作流文件时如何触发其余分支的GitHub Actions

解决方案 #

方案1：基于 repository_dispatch 实现全自动触发（无需修改版本分支，无额外维护成本）

这是最适配你需求的方案，操作步骤如下：

1. 在main分支的工作流文件中，将触发规则调整为同时支持repository_dispatch：

on:
  repository_dispatch:
    types: [build-version]

2. 进入仓库设置页，配置Webhook：

• Payload URL填https://api.github.com/repos/你的用户名/你的仓库名/dispatches
• 内容类型选application/json
• Secret填你生成的GitHub Personal Access Token（需要有repo权限）
• 触发事件只勾选Just the push event
• 在Webhook的请求体转换规则中，过滤掉push到main分支的请求，同时构造符合要求的请求体：

{
  "event_type": "build-version",
  "client_payload": {
    "branch": "${{ github.ref_name }}"
  }
}

3. 调整工作流的执行逻辑，第一步就checkout触发push的版本分支：

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout target version branch
        uses: actions/checkout@v4
        with:
          ref: ${{ github.event.client_payload.branch }}
      # 后续正常执行mvn clean package、docker build、docker push步骤即可

这个方案全程不需要对任何版本分支做修改，所有工作流逻辑只需要在main分支维护一次即可。

方案2：使用 workflow_dispatch 手动/半自动化触发

你提到的这个备选方案可以直接落地，操作步骤：

1. 在main分支的工作流中添加workflow_dispatch触发规则，添加分支输入参数：

on:
  workflow_dispatch:
    inputs:
      branch:
        description: "需要构建的版本分支名"
        required: true
        type: string

2. 触发方式有两种：

• 手动触发：进入GitHub仓库的Actions页面，选中对应工作流，点击Run workflow，输入要构建的分支名即可运行
• 自动化触发：写个简单的本地脚本，每次推送新版本分支后，调用GitHub CLI触发构建：

gh workflow run 你的工作流文件名.yml -f branch=software-1.2.3

3. 工作流执行逻辑和方案1一致，第一步checkout输入参数指定的分支即可。

方案3：同步工作流文件到所有版本分支（适合分支数量不多的场景）

如果你不想额外配置Webhook，也可以用GitHub Actions自带的文件同步能力，每次main分支的工作流文件更新时，自动把.github/workflows目录下的文件同步到所有版本分支，这样所有版本分支都有最新的工作流文件，原生的push触发规则就能正常生效。

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