如何在GitHub定时Action中复用指定分支的同仓库Workflow？

核心问题分析 #

定时触发的Workflow默认使用的GITHUB_TOKEN没有触发Workflow Dispatch的权限，即使配置了仓库权限，这个默认令牌的权限范围被限制，无法发起跨分支的Workflow调用——这就是你遇到Resource not accessible by integration错误的根本原因。

方案一：使用个人访问令牌（PAT）替代默认GITHUB_TOKEN #

这是最直接的解决方式，通过拥有足够权限的PAT来触发目标Workflow：

步骤1：创建符合权限要求的PAT #

1. 进入GitHub「Settings」→「Developer settings」→「Personal access tokens」→「Tokens (classic)」
2. 生成新令牌，勾选以下权限：
   • repo：私有仓库需勾选全权限，公开仓库可只选public_repo
   • workflow：允许触发Workflow Dispatch
3. 复制生成的令牌并妥善保存（仅显示一次）

步骤2：将PAT存入仓库机密 #

1. 进入目标仓库「Settings」→「Secrets and variables」→「Actions」→「New repository secret」
2. 命名为REPO_PAT，粘贴PAT值后保存

步骤3：修改nightly-qa.yml调用API（或Action） #

方式A：直接调用GitHub API

name: scheduled nightly build for qa
on:
  schedule:
    - cron: '0 2 * * *'  # 修正为每日2点整触发，原表达式会每小时第2分钟重复执行
  workflow_dispatch:

jobs:
  trigger-cd:
    runs-on: self-hosted
    name: Trigger CD workflow on develop branch
    steps:
      - name: Call CD workflow via API
        env:
          PAT: ${{ secrets.REPO_PAT }}
          ORG: <你的组织名>
          REPO: <你的仓库名>
        run: |
          curl -L \
            -X POST \
            -H "Accept: application/vnd.github+json" \
            -H "Authorization: Bearer $PAT" \
            -H "X-GitHub-Api-Version: 2022-11-28" \
            https://api.github.com/repos/$ORG/$REPO/actions/workflows/cd.yml/dispatches \
            -d '{"ref":"develop"}'

方式B：使用benc-uk/workflow-dispatch@v1 Action

name: scheduled nightly build for qa
on:
  schedule:
    - cron: '0 2 * * *'
  workflow_dispatch:

jobs:
  trigger-cd:
    runs-on: self-hosted
    name: Trigger CD workflow on develop branch
    steps:
      - uses: benc-uk/workflow-dispatch@v1
        with:
          workflow: cd.yml  # 目标Workflow的文件名
          ref: develop      # 指定触发的分支
          token: ${{ secrets.REPO_PAT }}  # 使用自定义PAT

方案二：无需额外令牌，调整Workflow逻辑复用 #

如果不想使用PAT，可通过修改cd.yml的逻辑，让它在被调用时自动切换到develop分支：

步骤1：修改cd.yml支持指定分支 #

在cd.yml中增加分支输入参数，允许外部指定拉取的分支：

# cd.yml示例
jobs:
  deploy:
    runs-on: self-hosted
    inputs:
      target-branch:
        description: '要部署的分支名称'
        required: false
        default: ${{ github.ref_name }}
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ inputs.target-branch }}
      # 后续构建、部署步骤保持原有逻辑不变

步骤2：在nightly-qa.yml中调用cd.yml并传参 #

name: scheduled nightly build for qa
on:
  schedule:
    - cron: '0 2 * * *'
  workflow_dispatch:

jobs:
  deploy-qa:
    uses: <OWNER>/<REPO>/.github/workflows/cd.yml@main  # 使用默认分支的Workflow文件
    with:
      target-branch: develop  # 指定拉取develop分支代码
    secrets: inherit  # 继承当前Workflow的机密（若cd.yml需要）

这种方式无需额外令牌，但要求你有权限修改cd.yml的逻辑。

注意事项 #

• 确保cron表达式正确：0 2 * * *才是每日2点整触发，原* 2 * * *会导致每小时第2分钟重复执行
• PAT权限最小化：仅勾选必要权限，避免过度授权
• 私有仓库需确认PAT持有者对目标仓库有写入权限

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