GitLab CI/CD中merge_request_event下依赖与阶段配置异常咨询

你的核心问题是MR流水线中build-branch无法找到run-tests任务，根源在于未明确指定run-tests在MR流水线中的运行规则，导致GitLab在MR流水线实例中未包含该任务，进而触发needs依赖错误。

问题拆解 #

1. 提交代码到MR分支时，GitLab默认触发两类流水线：
   • 分支流水线（CI_PIPELINE_SOURCE=push）：包含无规则限制的run-tests
   • MR流水线（CI_PIPELINE_SOURCE=merge_request_event）：仅包含有明确rules限制的build-branch（此时run-tests因未明确规则，在MR流水线中未被纳入）
2. 添加needs后，build-branch在MR流水线中尝试依赖run-tests，但该任务不在当前流水线实例内，因此报错。

正确配置 #

修改run-tests的规则，明确其在所有流水线类型中运行，同时保留build-branch的MR限制：

stages:
  - test
  - build

run-tests:
    image: node:lts
    stage: test
    before_script:
        - npm install
    script:
        - run_tests
    rules:
      - if: '$CI_PIPELINE_SOURCE == "push"'
      - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'

build-branch:
  image: docker:latest
  stage: build
  needs: ["run-tests"]
  script:
    - fancy_build_command
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'

配置说明 #

• run-tests通过rules明确在分支推送（push）和MR事件（merge_request_event）下都运行，确保MR流水线中存在该任务
• build-branch仅在MR事件下运行，且通过needs依赖run-tests，保证其在run-tests成功完成后执行
• 提交代码到MR分支后，MR流水线会按run-tests→build-branch的顺序执行，分支流水线仅运行run-tests，完全匹配你的需求

额外优化（可选） #

如果想避免触发分支流水线，仅保留MR流水线，可以在项目设置中开启仅合并请求流水线（路径：项目 → 设置 → CI/CD → 流水线 → 流水线类型），此时配置可简化为：

stages:
  - test
  - build

run-tests:
    image: node:lts
    stage: test
    before_script:
        - npm install
    script:
        - run_tests

build-branch:
  image: docker:latest
  stage: build
  needs: ["run-tests"]
  script:
    - fancy_build_command

开启该设置后，仅当存在MR时才会触发流水线，且run-tests和build-branch会按依赖顺序执行。

内容的提问来源于stack exchange，提问作者H van Buuren