GitLab CI 能否使用!reference标签复用rules及其他CI关键字？

核心结论 #

• 完全可以通过!reference标签复用rules配置，不存在这类关键字的复用限制
• 只要是GitLab CI 规范中允许用户自定义的合法配置项，都可以通过!reference完成跨配置段、跨引入文件的内容复用，没有刻意设置的可复用关键字白名单。

能力边界 #

和原生YAML提供的锚点（&/*）机制不同，!reference的复用范围不受单文件作用域限制：

• 哪怕目标配置是通过include关键字从其他外部配置文件引入的，只要对应的配置路径可被GitLab CI解析识别，就可以直接通过!reference提取内容复用
• 常见可复用的配置类型覆盖绝大多数流水线配置元素：
  • 流程控制类：rules、only/except、when、needs、dependencies、allow_failure
  • 运行环境类：image、services、cache、artifacts、retry、timeout
  • 执行逻辑类：script、before_script、after_script、tags、variables

实际复用示例 #

跨job复用通用rules配置的写法：

# 定义可被复用的通用规则模板
.common_pipeline_rules:
  rules:
    - if: $CI_COMMIT_BRANCH == "main"
      when: always
    - if: $CI_MERGE_REQUEST_ID
      when: manual

# 实际运行的job直接引用规则模板
unit_test_job:
  stage: test
  script: echo "running unit test"
  # 直接复用定义好的rules配置
  rules: !reference [.common_pipeline_rules, rules]

上述写法不需要重复书写规则逻辑，就能把模板段的整套规则配置完整绑定到当前job中。

使用注意点 #

• !reference的定位逻辑是严格匹配YAML层级路径的，只要目标层级是用户显式定义的合法CI配置，就不存在“某类关键字禁止复用”的限制
• 不可通过!reference对GitLab内置生成的动态配置、include引入逻辑本身做反向引用，仅能提取用户显式定义的静态配置内容

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