如何从下游项目触发上游项目的GitLab CI流水线？

以下是主流CI工具的具体实现方案，满足下游代码提交时自动触发上游流水线的需求：

GitLab CI 实现 #

步骤1：上游项目配置触发令牌 #

在GitLab上游项目的 Settings -> CI/CD -> Pipeline triggers 页面，创建一个新的触发器，记录生成的trigger token和上游项目的Project ID。

步骤2：下游项目添加触发逻辑 #

在下游项目的.gitlab-ci.yml中新增一个触发上游流水线的Job：

trigger-upstream-pipeline:
  stage: trigger
  only:
    - main  # 仅在main分支代码提交时触发
  script:
    - |
      curl --request POST \
           --form "token=$UPSTREAM_TRIGGER_TOKEN" \
           --form "ref=main" \
           "https://your-gitlab-domain/api/v4/projects/$UPSTREAM_PROJECT_ID/trigger/pipeline"
  variables:
    UPSTREAM_PROJECT_ID: "12345"  # 替换为上游项目的实际ID

配置敏感变量 #

在下游项目的 Settings -> CI/CD -> Variables 中添加UPSTREAM_TRIGGER_TOKEN，勾选"Protect variable"和"Mask variable"确保令牌安全。

GitHub Actions 实现 #

步骤1：上游项目配置可触发工作流 #

在GitHub上游项目的.github/workflows/upstream-trigger.yml中定义接收触发的工作流：

name: Upstream Pipeline
on:
  repository_dispatch:
    types: [downstream-code-push]  # 自定义触发事件类型
  workflow_dispatch:  # 保留手动触发选项（可选）

jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Execute upstream tasks
        run: |
          echo "Running upstream pipeline triggered by downstream commit"
          # 这里添加上游流水线的实际执行逻辑

步骤2：下游项目添加触发逻辑 #

在下游项目的.github/workflows/trigger-upstream.yml中添加触发上游的Job：

name: Trigger Upstream Pipeline
on:
  push:
    branches: [ main ]  # 仅在main分支代码提交时触发

jobs:
  trigger-upstream:
    runs-on: ubuntu-latest
    steps:
      - name: Dispatch upstream workflow
        uses: actions/github-script@v7
        with:
          github-token: ${{ secrets.UPSTREAM_REPO_PAT }}
          script: |
            await github.rest.actions.createWorkflowDispatch({
              owner: 'upstream-username',  # 替换为上游仓库所有者
              repo: 'upstream-repo-name',  # 替换为上游仓库名称
              workflow_id: 'upstream-trigger.yml',
              ref: 'main',  # 上游要触发的分支
              inputs: {}  # 可传递自定义参数给上游（可选）
            })

配置访问令牌 #

在下游项目的 Settings -> Secrets and variables -> Actions 中添加UPSTREAM_REPO_PAT，该令牌需要拥有上游仓库的repo权限，确保能触发工作流。

通用注意事项 #

• 权限最小化：触发用的令牌仅授予必要权限，避免过度授权带来的安全风险
• 分支过滤：根据业务需求设置触发分支，减少不必要的流水线运行
• 错误处理：可在触发脚本中添加返回码检查，比如curl -f确保调用失败时Job标记为失败

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