GitLab CI/CD规则复用及继承变量失效问题排查

原有配置场景 #

现有拆分后的CI/CD配置文件如下：

.gitlab-ci.yml #

include:
  - local: 'ci-cd/build.yml'
  - local: 'ci-cd/deploy.yml'

stages:
  - Initialize
  - Build
  - Deploy

variables:
  RUN_BUILDS: "true"
  DEPLOY:
    value: "false"
    description: "Deploy ?"

Initialize stuff:
  stage: Initialize
  script:
    - echo "Initialized"

ci-cd/build.yml #

Build Job:
  stage: Build
  script:
    - echo "Building.... :)"
    - mkdir bin
    - cat project/hugabuga.txt >> bin/output.txt
    - echo -e "\nBuilding done!" >> bin/output.txt
    - echo $CI_COMMIT_MESSAGE
  artifacts:
    paths:
      - bin/**/*
    expire_in: 1h
  rules:
    - if: '$RUN_BUILDS == "true"'
      changes:
        - project/**/*
    - if: '$DEPLOY == "true" || $CI_COMMIT_MESSAGE =~ "/deploy/"'

ci-cd/deploy.yml #

Deploy Job:
  needs: ["Build Job"]
  before_script:
    - echo "Deploying..."
  script:
    - cat bin/output.txt
    - echo $DEPLOY_LOCAL
    - echo $DEPLOY
  rules:
    - if: '$DEPLOY == "true" || $CI_COMMIT_MESSAGE =~ "/deploy/"'

可以看到规则- if: '$DEPLOY == "true" || $CI_COMMIT_MESSAGE =~ "/deploy/"'在Build Job和Deploy Job中重复编写，需要实现规则复用，同时满足以下需求：

核心需求 #

• 当project/**/*路径变更且RUN_BUILDS为true时，触发Build Job；
• 当手动设置DEPLOY=true或提交消息匹配/deploy/正则时，独立触发Build Job；
• Deploy Job仅在手动设DEPLOY=true或提交消息匹配正则时触发，不会因路径变更触发；
• Deploy Job不随所有Build Job触发，仅满足特定条件时运行。

尝试的复用方案及问题 #

尝试通过基础任务.deploy-base让部署任务继承规则，通过覆盖变量实现不同触发条件：

.deploy-base:
  stage: Deploy
  variables:
    DEPLOY_LOCAL: "false"
    MSG_PATTERN: /default/ 
  rules:
    - if: $DEPLOY_LOCAL == "true" || $CI_COMMIT_MESSAGE =~ $MSG_PATTERN   

Deploy Job: 
  extends: .deploy-base
  variables:
    DEPLOY_LOCAL: $DEPLOY
    MSG_PATTERN: /deploy/ 
  needs: ["Build Job"]
  before_script:
    - echo "Deploying..."
  script:
    - cat bin/output.txt
    - echo $DEPLOY_LOCAL
    - echo $DEPLOY

但遇到以下问题：

1. 提交消息含deploy时，Build Job和Deploy Job均正常触发；
2. 手动设置DEPLOY=true时，仅Build Job触发，Deploy Job不触发；
3. 注释Build Job中的路径变更规则后，手动设置DEPLOY=true时，两个任务均不触发。

问题原因分析 #

GitLab CI的规则在流水线初始化阶段完成解析，变量替换逻辑存在优先级：

• 基础任务.deploy-base中的规则if: $DEPLOY_LOCAL == "true"会被直接解析为字符串比较'$DEPLOY' == "true"，而非引用$DEPLOY变量的实际值。因为在解析基础任务规则时，继承后的变量覆盖（DEPLOY_LOCAL: $DEPLOY）还未生效，导致规则条件始终不成立。
• 当注释Build Job的路径规则后，若Deploy Job因规则解析错误未触发，而Build Job的规则本身虽满足$DEPLOY=true，但如果流水线解析时因Deploy Job的规则语法问题（如未加引号）导致整体任务解析异常，会出现两个任务都不触发的情况。

解决办法 #

方案1：使用!reference复用规则片段 #

创建公共规则文件ci-cd/rules.yml，定义可复用的规则：

.rules_deploy_trigger:
  - if: '$DEPLOY == "true" || $CI_COMMIT_MESSAGE =~ "/deploy/"'

在build.yml中引用规则：

Build Job:
  # ... 原有配置
  rules:
    - if: '$RUN_BUILDS == "true"'
      changes:
        - project/**/*
    - !reference [.rules_deploy_trigger, 0]

在deploy.yml中引用规则：

Deploy Job:
  # ... 原有配置
  rules:
    - !reference [.rules_deploy_trigger, 0]

这种方式直接复用规则片段，避免变量解析问题，是GitLab CI推荐的规则复用方式。

方案2：修正基础任务的变量传递逻辑 #

如果要保留基础任务的继承模式，需避免在规则中使用间接变量，直接引用原始变量或使用正确的变量插值：

.deploy-base:
  stage: Deploy
  rules:
    - if: '$DEPLOY == "true" || $CI_COMMIT_MESSAGE =~ $MSG_PATTERN'
  variables:
    MSG_PATTERN: "/default/"

Deploy Job:
  extends: .deploy-base
  variables:
    MSG_PATTERN: "/deploy/"
  needs: ["Build Job"]
  before_script:
    - echo "Deploying..."
  script:
    - cat bin/output.txt
    - echo $DEPLOY

这种方式去掉了中间变量DEPLOY_LOCAL，直接在规则中使用$DEPLOY，确保变量值在流水线初始化时被正确解析。

补充说明 #

• 手动运行流水线时，需确保在变量设置区域正确输入DEPLOY=true，而非仅在描述中填写；
• 规则中的条件字符串需用单引号包裹，避免YAML解析时的语法错误；
• needs依赖的任务必须触发，否则当前任务也不会触发，因此需确保Build Job在Deploy Job触发的条件下一定会运行。

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