GitLab CI中rules下when:never无法阻止流水线触发的问题求助

问题回顾 #

在GitLab EE 15.0.5中配置流水线规则时遇到以下问题：

• 配置两条规则时，即使!A为真，流水线仍会触发，不符合预期：

  rules:
   - if: ! A
     when: never
   - if: B
  

• 使用rules: - if: A && B可正常阻止流水线，但该方式无法适配含exists的场景，且无法实现规则复用。
• 尝试用!reference复用规则片段后问题依旧：

  .rules:
    rules:
      - if: ! A
        when: never
      - exists:
          - "$ex"
        when: never
  
  rules:
      - !reference [ .rules, rules ]
      - if: $var =~ /^.*abcd.*$/
  

可行解决方案 #

1. 修正逻辑非表达式的语法 #

GitLab CI的if条件中，逻辑非（!或NOT）需要正确覆盖整个条件，复合条件必须加括号，否则会导致逻辑解析错误。
错误示例：

if: !$CI_COMMIT_BRANCH == 'main'  # 解析为 (!$CI_COMMIT_BRANCH) == 'main'，逻辑错误

正确示例：

if: !($CI_COMMIT_BRANCH == 'main')  # 正确覆盖整个条件
# 或使用NOT关键字
if: NOT ($CI_COMMIT_BRANCH == 'main')

2. 严格遵循规则匹配顺序 #

GitLab CI的规则按顺序执行，只要某条规则匹配成功，就会执行对应的when动作，后续规则不再检查。确保所有when: never的阻止规则放在触发规则之前，一旦匹配阻止条件就直接终止流水线触发。

调整后的复用规则写法：

# 通用阻止规则片段
.rules-block:
  rules:
    - if: !($A_CONDITION)  # 修正后的逻辑非表达式
      when: never
    - exists:
        - "$ex"
      when: never

# 流水线规则
rules:
  - !reference [.rules-block, rules]
  # 触发规则放在最后，仅当前面的阻止规则都不匹配时才检查
  - if: $var =~ /^.*abcd.*$/

3. 合并阻止条件（适配复杂场景） #

若需将exists等非if条件转换为可合并的表达式，可通过预定义变量实现：

variables:
  # 提前判断文件是否存在，将结果存入变量
  FILE_EXISTS: $(test -f "$ex" && echo "true" || echo "false")

.rules-block:
  rules:
    # 合并所有阻止条件，用OR连接
    - if: !($A_CONDITION) || $FILE_EXISTS == "true"
      when: never

rules:
  - !reference [.rules-block, rules]
  - if: $var =~ /^.*abcd.*$/

4. 排查版本bug #

GitLab 15.0.x早期版本可能存在规则解析或!reference引用的bug，建议升级到15.x系列的较新版本（如15.10+），修复已知的规则匹配问题。

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