GitLab CI配置：仅为MR与默认分支运行分支流水线的问题

需求背景 #

需要实现：

• 仅在合并请求（MR）和默认分支触发分支流水线，无MR的分支推送操作不触发流水线
• 代码质量结果能正常显示在MR报告/组件中，解决当前源分支与目标分支制品差异展示异常的问题

当前配置的问题 #

你尝试的以下规则配置，在首次推送分支后打开MR时无法启动流水线：

- if: $CI_PIPELINE_SOURCE == "merge_request_event"
  when: never
- if: $CI_COMMIT_REF_NAME && $CI_OPEN_MERGE_REQUESTS
- if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH

原因是$CI_OPEN_MERGE_REQUESTS变量在首次创建MR的瞬间还未同步，导致规则不匹配，流水线无法触发。

修正后的规则配置 #

使用以下配置可解决问题，同时满足需求：

rules:
  # 禁用独立的MR事件流水线，改用分支流水线关联MR
  - if: $CI_PIPELINE_SOURCE == "merge_request_event"
    when: never
  # 默认分支始终触发流水线
  - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
  # 分支关联MR时触发（覆盖首次创建MR的场景）
  - if: $CI_MERGE_REQUEST_IID

配置说明 #

• $CI_MERGE_REQUEST_IID在分支关联MR时会被自动注入，哪怕是首次创建MR的场景也能正确触发分支流水线
• 彻底避免无MR的分支推送触发流水线
• 保留默认分支的流水线触发逻辑

MR制品关联的补充配置 #

为确保代码质量报告能正确关联到MR，可在代码质量作业中添加如下配置：

code_quality:
  stage: test
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
      when: never
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
    - if: $CI_MERGE_REQUEST_IID
  script:
    - # 执行你的代码质量扫描命令（如SonarQube、CodeClimate等）
  artifacts:
    reports:
      codequality: gl-code-quality-report.json
    paths:
      - gl-code-quality-report.json

GitLab会自动将分支流水线生成的代码质量报告关联到对应MR，在MR视图中正常展示差异对比。

版本适配 #

当前使用的GitLab v17.3.4-ee和自托管Runner 16.9.0完全支持上述变量与配置逻辑，无需升级版本。

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