如何在GitHub Actions中批量或并行检出多个代码仓库？

问题场景 #

我们的站点构建器基于多独立仓库模块搭建（非monorepo架构），部分模块示例包括：

Accounts
Blog
Clients
Configuration
Contacts
Courses
Discounts
Galleries
...

当前在GitHub Action中通过actions/checkout@v3逐个检出20余个模块，配置示例如下：

- name: Get Modules/Blog
        uses: actions/checkout@v3
        with:
          repository: Modules/Blog
          token: ${{ secrets.PAT }}
          path: Modules/Blog

      - name: Get Modules/Configuration
        uses: actions/checkout@v3
        with:
          repository: Modules/Configuration
          token: ${{ secrets.PAT }}
          path: Modules/Configuration

      - name: Get Modules/Contacts
        uses: actions/checkout@v3
        with:
          repository: Modules/Contacts
          token: ${{ secrets.PAT }}
          path: Modules/Contacts

这种串行逐个检出的方式耗时约20秒，且日志冗余增加调试难度，需要更高效的批量检出方案。

可行解决方案 #

1. 矩阵策略并行检出 #

利用GitHub Actions的矩阵策略，将模块列表定义为矩阵变量，并行执行checkout操作，大幅缩短总耗时。配置示例：

jobs:
  checkout-modules:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        module: [Accounts, Blog, Clients, Configuration, Contacts, Courses, Discounts, Galleries]
      # 可选：限制并行数量，避免触发API速率限制
      # max-parallel: 10
    steps:
      - name: Checkout ${{ matrix.module }}
        uses: actions/checkout@v3
        with:
          repository: Modules/${{ matrix.module }}
          token: ${{ secrets.PAT }}
          path: Modules/${{ matrix.module }}

优势：并行执行后总耗时接近单个模块的检出时间；配置简洁无重复代码；日志按模块分组，便于定位问题。

2. 自定义Shell脚本批量克隆 #

编写Shell脚本一次性完成所有模块的Git克隆，减少Action调用的开销。

首先在主仓库中创建clone-modules.sh脚本：

#!/bin/bash
# 定义需要克隆的模块列表
MODULES=("Accounts" "Blog" "Clients" "Configuration" "Contacts" "Courses" "Discounts" "Galleries")
# 接收传入的PAT令牌
TOKEN=$1

# 创建模块存放目录
mkdir -p Modules

# 循环克隆每个模块
for MODULE in "${MODULES[@]}"
do
  git clone https://${TOKEN}@github.com/Modules/${MODULE}.git Modules/${MODULE}
  # 可选：如果只需要最新提交，添加--depth 1减少克隆体积
  # git clone --depth 1 https://${TOKEN}@github.com/Modules/${MODULE}.git Modules/${MODULE}
done

然后在GitHub Action中调用该脚本：

- name: Batch checkout modules via script
        run: |
          chmod +x ./clone-modules.sh
          ./clone-modules.sh ${{ secrets.PAT }}

优势：单次执行完成所有克隆，降低Action调度开销；可灵活添加Git参数（如浅克隆、指定分支）；日志更简洁。

3. 第三方批量检出Action #

使用社区维护的批量checkout Action（注意选择维护活跃的项目以保障安全），示例配置：

- name: Checkout multiple modules
        uses: actions/checkout-multiple@v1
        with:
          repositories: |
            Modules/Accounts:Modules/Accounts
            Modules/Blog:Modules/Blog
            Modules/Clients:Modules/Clients
          token: ${{ secrets.PAT }}

优势：无需编写脚本，配置简单直观；封装了批量操作逻辑。

注意事项 #

• 并行检出时，若模块数量过多，可通过max-parallel参数限制并行数，避免触发GitHub API速率限制。
• 自定义脚本中需妥善处理令牌，避免泄露；使用HTTPS克隆时将令牌嵌入URL，确保仓库访问权限正确。
• 第三方Action需优先选择官方或高星维护项目，避免引入安全风险。

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