GitLab Workflow配置需求：实现分支/MR/定时流水线并避免重复

问题背景 #

需在GitLab v16.3.4-ee环境中实现以下流水线功能，且避免MR流程中重复触发分支与MR流水线：

• 分支流水线（Branch pipelines）
• 带MR标签的合并请求流水线
• 定时流水线（Schedule pipelines）

工作流逻辑要求：

1. 推送功能分支代码时，触发包含两个初始阶段的分支流水线
2. 初始阶段通过后创建MR，在初始阶段基础上执行更多专属阶段

当前配置中分支流水线无法正常运行，其余功能正常，原配置如下：

workflow:
  rules:
    - if: $CI_MERGE_REQUEST_IID
    - if: $CI_COMMIT_TAG
    - if: $CI_PIPELINE_SOURCE == "schedule"
    - if: $CI_COMMIT_REF_PROTECTED == "true"

解决方案配置 #

修正后的Workflow规则 #

workflow:
  rules:
    # 优先匹配MR流水线，避免同时触发分支流水线
    - if: $CI_MERGE_REQUEST_IID
    # 标签触发的流水线
    - if: $CI_COMMIT_TAG
    # 定时触发的流水线
    - if: $CI_PIPELINE_SOURCE == "schedule"
    # 保护分支的分支流水线
    - if: $CI_COMMIT_REF_PROTECTED == "true"
    # 非保护功能分支的分支流水线（排除MR触发场景）
    - if: $CI_COMMIT_BRANCH && $CI_PIPELINE_SOURCE != "merge_request_event"

阶段区分的Job配置 #

通过Job规则区分初始阶段与MR专属阶段：

# ------------------------------
# 初始阶段：分支/MR/定时流水线均执行
# ------------------------------
build:
  stage: build
  script:
    - echo "执行构建操作"
  rules:
    - if: $CI_MERGE_REQUEST_IID
    - if: $CI_COMMIT_BRANCH && $CI_PIPELINE_SOURCE != "merge_request_event"
    - if: $CI_PIPELINE_SOURCE == "schedule"

test:
  stage: test
  script:
    - echo "执行测试操作"
  rules:
    - if: $CI_MERGE_REQUEST_IID
    - if: $CI_COMMIT_BRANCH && $CI_PIPELINE_SOURCE != "merge_request_event"
    - if: $CI_PIPELINE_SOURCE == "schedule"

# ------------------------------
# MR专属阶段：仅MR流水线执行
# ------------------------------
mr_code_review:
  stage: review
  script:
    - echo "执行MR代码审查"
  rules:
    - if: $CI_MERGE_REQUEST_IID

mr_preview_deploy:
  stage: preview
  script:
    - echo "部署MR预览环境"
  rules:
    - if: $CI_MERGE_REQUEST_IID

配置说明 #

1. Workflow规则优先级：将MR规则放在最顶部，确保当存在MR时，仅触发MR流水线，不会同时触发分支流水线，解决重复流水线问题。
2. 功能分支适配：最后一条规则匹配非保护功能分支，且排除MR触发场景，确保推送功能分支时正常触发分支流水线。
3. 阶段区分：初始阶段Job配置了多场景规则，保证分支、MR、定时流水线都能执行基础校验；MR专属阶段仅在MR场景下触发，满足工作流逻辑要求。
4. 可选优化：若想让MR流水线复用分支流水线的构建产物，可通过needs或dependencies配置关联分支流水线的Job，减少重复执行。

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