Github Action工作流与分支保护配置问题求助

方案1：PR自动格式化后自动触发Build工作流 #

关键配置要点 #

1. 创建带权限的PAT

   • 生成PAT时勾选repo权限（包含workflow子权限），确保能触发后续工作流。
   • 将PAT存入仓库Secrets，命名为FORMAT_PAT。

2. 修改Format工作流

   • 仅在有格式化变更时推送，避免无意义提交。
   • 使用PAT替代默认GITHUB_TOKEN执行推送，绕过GitHub的事件触发限制。

示例Format工作流配置：

name: Format
on:
  pull_request:
    branches: [master]

jobs:
  fmt:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0 # 拉取完整历史，确保diff判断准确

      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          go-version: '1.21'

      - name: Run gofmt
        run: gofmt -w .

      - name: Check for format changes
        id: check_diff
        run: |
          git diff --exit-code || echo "has_changes=true" >> $GITHUB_OUTPUT

      - name: Push formatted code
        if: steps.check_diff.outputs.has_changes == 'true'
        run: |
          git config --global user.name "github-actions[bot]"
          git config --global user.email "github-actions[bot]@users.noreply.github.com"
          git add .
          git commit -m "style: auto format code"
          # 用PAT推送，触发Build工作流
          git push https://${{ secrets.FORMAT_PAT }}@github.com/${{ github.repository }}.git HEAD:${{ github.head_ref }}

3. 调整Build工作流触发条件
   修改Build工作流的触发规则，包含pull_request和push事件，确保Format推送的新提交能触发Build：

name: Build
on:
  pull_request:
    branches: [master]
  push:
    branches-ignore: [master] # 避免master分支推送重复触发，按需调整
jobs:
  build-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-go@v5
        with:
          go-version: '1.21'
      - name: Run tests
        run: go test ./...
      - name: Build project
        run: go build -v ./...

配置完成后，PR创建时Format工作流自动格式化并推送新提交，PAT推送会触发Build工作流，PR状态会同步更新Build结果，满足分支保护要求即可正常合并。

方案2：Format工作流在Master分支Push触发并绕过分支保护 #

关键配置要点 #

1. 创建专用机器人账号并生成PAT

   • 注册GitHub机器人账号，加入仓库并赋予写权限。
   • 为该账号生成带repo权限的PAT，存入仓库Secrets（如MASTER_FORMAT_PAT）。

2. 配置分支保护策略

   • 进入仓库「Settings」→「Branches」→「Branch protection rules」，找到master分支的规则。
   • 在「Allow specified actors to bypass required pull requests and required status checks」中添加机器人账号，允许其绕过分支保护。

3. 修改Format工作流触发条件
   设置工作流仅在master分支推送时触发，使用机器人账号的PAT执行格式化推送：

name: Format Master
on:
  push:
    branches: [master]

jobs:
  fmt-master:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
          token: ${{ secrets.MASTER_FORMAT_PAT }} # 使用机器人PAT拉取代码

      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          go-version: '1.21'

      - name: Run gofmt
        run: gofmt -w .

      - name: Push formatted code
        run: |
          git config --global user.name "你的机器人账号名"
          git config --global user.email "机器人账号邮箱"
          git add .
          git commit -m "style: auto format master branch code"
          git push # 机器人账号已配置绕过分支保护，可直接推送

这种方案下，master分支推送后自动完成格式化，机器人账号的提交会绕过分支保护策略，无需PR即可直接推送。

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