同一组织下Github Actions跨仓库提交/无提交部署GH Pages咨询

1. 当前事件触发报错的原因 #

• 接口调用不匹配：你调用的是workflow_dispatch事件的专属触发接口，和你配置监听的repository_dispatch事件属于两类不同的触发逻辑，repository_dispatch的正确触发接口路径为POST /repos/{owner}/{repo}/dispatches。
• 认证方式无效：Github已停用账号密码形式的Basic Auth API调用方式，你需要生成个人访问令牌（PAT），认证时用户名填Github账号，密码填生成的PAT，且PAT需要勾选repo、workflow权限，若操作组织名下仓库还需要开通对应组织的访问授权。
• 权限不足：触发跨仓库事件要求操作账号对目标仓库拥有管理员权限。

2. 相关疑问解答 #

• Secrets安全性说明：将PAT存入Github Secrets是完全安全的，Secrets存入后确实无法被读取，仅会在Actions运行时按需解密注入环境，不会在日志中明文输出，完全符合组织级项目的安全要求。
• 跨仓库提交实现：只需在执行actions/checkout步骤时注入拥有目标仓库读写权限的PAT，后续的git commit、git push操作就可以正常执行。

3. 双仓库自动同步方案（适配现有架构） #

主仓库配置 #

在主仓库的.github/workflows目录下新增触发流程文件，master分支收到push时自动向次仓库发送事件：

on:
  push:
    branches: [ master ]
jobs:
  trigger-build:
    runs-on: ubuntu-latest
    steps:
      - name: Trigger site build
        uses: peter-evans/repository-dispatch@v2
        with:
          token: ${{ secrets.ACTION_PAT }}
          repository: TiddlyWiki/tiddlywiki.github.com
          event-type: build-site
          client-payload: '{"commit_sha": "${{ github.sha }}", "commit_msg": "${{ github.event.head_commit.message }}"}'

次仓库配置 #

将你现有构建流程的触发条件改为监听repository_dispatch事件，同时修改checkout步骤注入PAT：

on:
  repository_dispatch:
    types: [build-site]

jobs:
  build-site:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.ACTION_PAT }}

      - name: get TiddlyWiki source
        run: git clone https://github.com/TiddlyWiki/TiddlyWiki.git

      - name: install and build
        run: |
          cd ./TiddlyWiki
          npm i
          npm run build-site
          cd ..

      - name: move and commit resulting file
        run: |
          mv ./TiddlyWiki/build/cooked/*/index.html ./
          git config --global user.name "github-actions[bot]"
          git config --global user.email "github-actions[bot]@users.noreply.github.com"
          git add ./index.html
          git commit -m "autoupdate from main repo commit ${{ github.event.client_payload.commit_sha }}: ${{ github.event.client_payload.commit_msg }}"
          git push

4. 单仓库免提交构建产物方案（更推荐，无提交历史污染） #

Github Pages已支持直接通过Actions构建并部署页面，不需要将构建产物提交到仓库，完全不会污染提交历史，也不需要维护额外的次仓库：

配置步骤 #

1. 打开主仓库的Settings → Pages，将部署源设置为Github Actions。
2. 在主仓库的.github/workflows目录下新增构建部署配置文件：

on:
  push:
    branches: [ master ]
permissions:
  contents: read
  pages: write
  id-token: write
concurrency:
  group: "pages"
  cancel-in-progress: false
jobs:
  build-and-deploy:
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install dependencies and build
        run: |
          npm i
          npm run build-site
      - name: Upload build artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: ./build/cooked/*/
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4

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