多依赖Lib仓库项目如何通过GitHub Action推送代码至其他仓库develop分支？

核心方案 #

没错，这类场景的最佳实践就是在你的lib仓库中配置Action，当lib版本更新时，自动遍历所有依赖该lib的项目仓库，修改依赖版本并推送到它们的develop分支。

具体步骤 #

1. 创建跨仓库权限的GitHub Token #

• 生成一个带repo权限的Personal Access Token（PAT），这个Token需要能访问所有依赖项目的仓库。
• 在lib仓库的Settings > Secrets and variables > Actions中添加这个Token，命名为DEPENDENCY_UPDATE_TOKEN。

2. 编写GitHub Action配置文件 #

在lib仓库的.github/workflows/update-deps.yml中添加以下内容：

name: Update Dependencies in Consumer Repos
on:
  release:
    types: [published] # 当lib发布新版本时触发
  workflow_dispatch: # 支持手动触发

jobs:
  update-deps:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout lib repo
        uses: actions/checkout@v4

      - name: Set up Node.js (根据技术栈调整，比如Python/Java等)
        uses: actions/setup-node@v4
        with:
          node-version: 20

      - name: Get new lib version
        id: get-version
        run: echo "version=$(jq -r '.version' package.json)" >> $GITHUB_OUTPUT # 以package.json为例，按需调整

      - name: Update consumer repos
        env:
          NEW_VERSION: ${{ steps.get-version.outputs.version }}
          GITHUB_TOKEN: ${{ secrets.DEPENDENCY_UPDATE_TOKEN }}
        run: |
          # 定义依赖项目仓库列表，格式为 "owner/repo"
          CONSUMER_REPOS=(
            "your-org/project-repo-1"
            "your-org/project-repo-2"
            "your-org/project-repo-3"
          )

          for REPO in "${CONSUMER_REPOS[@]}"; do
            # 克隆目标仓库的develop分支
            git clone --branch develop https://$GITHUB_TOKEN@github.com/$REPO.git
            REPO_NAME=$(basename $REPO)
            cd $REPO_NAME

            # 修改依赖版本，此处以Node.js的package.json为例，按需替换为对应技术栈的命令
            jq --arg version "$NEW_VERSION" '.dependencies["your-lib-name"] = $version' package.json > temp.json && mv temp.json package.json

            # 提交并推送
            git config user.name "GitHub Action Bot"
            git config user.email "action@github.com"
            git add package.json
            git commit -m "chore: update your-lib-name to v$NEW_VERSION"
            git push origin develop

            cd ..
            rm -rf $REPO_NAME
          done

3. 关键细节适配 #

• 技术栈调整：如果是Python（修改requirements.txt/pyproject.toml）、Java（修改pom.xml/build.gradle）等项目，需要替换版本修改的命令，比如用sed做文本替换、xmlstarlet修改XML文件。
• 分支保护兼容：如果依赖项目的develop分支开启了分支保护（比如需要PR、状态检查），可以调整逻辑：先创建feature分支，推送后用GitHub CLI的gh pr create命令自动生成PR到develop，而非直接推送。
• 错误处理优化：可以在循环中加入set -e或错误捕获逻辑，避免单个仓库失败导致整个流程中断。
• 动态仓库列表：如果依赖项目较多，可将仓库列表存入单独的配置文件（如consumer-repos.json），让Action读取该文件遍历，更易维护。

4. 备选方案（非lib仓库触发） #

虽然主流方案是在lib仓库触发，也有变通方式：在每个依赖项目中配置定时Action，定期检查lib的最新版本，发现更新时自动修改并推送。但这种方案需要每个项目单独配置，且触发时机是定时任务，不如lib仓库触发及时。

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