私有仓库间调用Reusable Workflow的替代方案及执行报错问询

问题原因解析 #

你遇到的问题本质有两个：

1. uses的层级限制：uses在steps里只能引用GitHub Action（包括Composite Action、Docker Action等），而Reusable Workflow（RW）是job层级的引用对象，根本不支持在step里调用。
2. 工作流预解析机制：GitHub在执行工作流前会先静态解析所有uses引用，此时你通过actions/checkout动态下载的中央仓库文件还不存在，所以会提示找不到action.yml这类Action必需的文件。

可行替代方案 #

方案1：用GitHub CLI触发中央仓库的Reusable Workflow #

既然RW不能在step里调用，可直接通过gh workflow run命令在step中触发中央仓库的工作流，前提是你的PAT拥有两个仓库的权限：

name: Trigger Central Workflow

on: [push]

jobs:
  trigger-central-workflow:
    runs-on: ubuntu-latest
    steps:
      - name: Install GitHub CLI
        run: sudo apt install gh -y
      - name: Authenticate with GitHub
        run: echo "${{ secrets.PAT_TOKEN }}" | gh auth login --with-token
      - name: Trigger central repo workflow
        run: gh workflow run workflow.yml --repo kalanatd/central-repo --ref main
        # 如需传递参数，添加 -f 参数，比如 -f env=production

方案2：将Reusable Workflow转为Composite Action #

把中央仓库的工作逻辑封装成Composite Action（支持在step里引用），这样调用仓库可以直接引用中央仓库的Action：

1. 在中央仓库创建.github/actions/[action-name]/action.yml，示例：

name: 'My Composite Action'
description: 'Reusable logic from central repo'
runs:
  using: 'composite'
  steps:
    - name: Step 1
      run: echo "Hello from central action"
      shell: bash
    # 添加你的工作流步骤

2. 在调用仓库的工作流中直接引用：

name: Use Central Action

on: [push]

jobs:
  use-central-action:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout calling repo
        uses: actions/checkout@v4
      - name: Run central composite action
        uses: kalanatd/central-repo/.github/actions/[action-name]@main
        with:
          # 如需传递参数，在这里定义
          token: ${{ secrets.PAT_TOKEN }}

方案3：同步中央仓库工作流到调用仓库 #

写一个自动化脚本（或用GitHub Action），定期将中央仓库的工作流文件同步到所有调用仓库，确保调用仓库的工作流始终和中央仓库保持一致：

name: Sync Central Workflows

on:
  push:
    branches: [main]
    paths:
      - '.github/workflows/**'

jobs:
  sync-to-calling-repos:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout central repo
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Sync to calling repo 1
        run: |
          git clone https://${{ secrets.PAT_TOKEN }}@github.com/kalanatd/calling-repo-1.git
          cp -r .github/workflows/* calling-repo-1/.github/workflows/
          cd calling-repo-1
          git config user.name "GitHub Actions"
          git config user.email "actions@github.com"
          git add .github/workflows/
          git commit -m "Sync workflows from central repo"
          git push

针对你的疑问的明确回答 #

是的，Reusable Workflow无法在steps下调用，而且由于GitHub工作流的预解析机制，动态下载的RW文件在工作流解析阶段还未生成，所以完全无法通过这种方式直接调用。必须采用上述替代方案实现私有仓库间的工作流复用。

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