如何触发不覆盖下游项目分支/提交结果的GitLab下游流水线？

背景回顾 #

GitLab中存在两个关联项目：可执行项目myexecutable以子模块形式依赖库项目mylibrary。当前通过库项目流水线触发下游可执行项目流水线，验证库修改是否破坏可执行项目，但存在下游流水线会更新myexecutable的main分支CI状态，导致误判的问题。

1. 能否让下游流水线仅显示在触发项目的流水线中？ #

可以实现，核心思路是让下游流水线运行在分离HEAD状态，避免关联到myexecutable的main分支，从而不影响该分支的CI状态：

• 调整库项目的触发配置，传递库的具体提交哈希而非分支名：

  downstream_myexecutable:
    stage: first
    trigger:
      project: myexecutable
      strategy: depend
    variables:
      LIBRARY_COMMIT_SHA: $CI_COMMIT_SHA
      TRIGGERED_BY_LIBRARY: "true"
  

• 在myexecutable的CI中，仅当检测到来自库的触发时，切换子模块到指定提交并运行测试，且该流水线以分离HEAD状态执行：

  build_and_test_for_library:
    script:
      # 初始化子模块
      - git submodule update --init
      # 切换子模块到库的目标提交
      - cd mylibrary
      - git fetch origin $LIBRARY_COMMIT_SHA
      - git checkout $LIBRARY_COMMIT_SHA
      - cd ..
      # 执行构建和测试
      - make build && make test
    rules:
      - if: $TRIGGERED_BY_LIBRARY == "true"
        when: always
      - when: never
  

  这种方式下，下游流水线属于独立的触发式流水线，只会关联到库项目的触发流水线，不会更新myexecutable的main分支CI状态，仅在库的流水线中可见。

2. GitLab是否有现成的子模块切换/跨项目验证方案？ #

有成熟的现成方案，针对这类跨项目依赖验证的常见需求，推荐两种实践：

方案一：在库项目流水线中直接运行可执行项目测试

无需触发下游流水线，直接在库的流水线里拉取可执行项目代码，替换子模块为当前库的提交后执行测试，所有结果都集中在库的流水线中，完全不影响myexecutable的分支状态：

test_myexecutable_compatibility:
  stage: test
  script:
    # 克隆可执行项目（使用CI_JOB_TOKEN授权）
    - git clone https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.example.com/myexecutable.git
    - cd myexecutable
    # 更新子模块地址并切换到当前库提交
    - git submodule set-url mylibrary https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.example.com/mylibrary.git
    - git submodule update --init
    - cd mylibrary
    - git fetch origin ${CI_COMMIT_SHA}
    - git checkout ${CI_COMMIT_SHA}
    - cd ..
    # 执行可执行项目的构建与测试
    - make build && make test

方案二：使用GitLab下游流水线的分离HEAD模式

结合前面问题1的配置，利用GitLab的触发变量与规则控制，让下游流水线在分离HEAD状态下运行，仅关联触发方流水线。这种方式保留了下游流水线的独立性，同时避免污染目标项目的分支CI状态，适合需要完整复用可执行项目CI流程的场景。

另外，GitLab的Merge Request Pipeline可以和上述方案结合，在库项目的MR中自动触发验证，提前拦截破坏依赖的修改，完全匹配多人协作的需求。

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