GitLab CI如何使用rules检查值是否存在于锚点定义的数组中

原有写法报错无法生效，核心原因有两点：

• GitLab CI的rules:if字段仅接受字符串类型的表达式，其中的in操作符右侧仅支持GitLab内置的数组类预定义变量，不支持直接嵌入YAML原生数组结构。
• YAML锚点在文件解析阶段生效，无法直接嵌入到if对应的字符串值内部做语法拼接，解析后会触发类型不匹配错误。

方案1：复用规则锚点（推荐，全版本兼容，支持复杂逻辑） #

直接将分支匹配逻辑封装为通用规则锚点，所有需要该判断的作业直接引用即可，后续维护分支列表只需要修改一处：

# 定义通用分支匹配规则锚点
.allowed_branch_rules: &ALLOWED_BRANCH_RULES
  rules:
    - if: '$CI_COMMIT_BRANCH == "master"'
    - if: '$CI_COMMIT_BRANCH == "my-feature-branch"'
    # 不需要匹配时跳过流水线就放开下面的注释
    # - when: never

# 业务作业直接引用规则
your_pipeline_job:
  <<: *ALLOWED_BRANCH_RULES
  script:
    - echo "分支在允许列表内，执行对应流水线操作"

方案2：only关键字直接引用分支数组锚点（适合简单分支过滤场景） #

如果只需要做纯分支过滤，不需要叠加变量判断、文件变更判断等复杂规则，可以直接在only.refs中引用已经定义好的分支数组锚点，原生支持该语法：

# 你之前定义的分支列表锚点不需要修改
.branches:
  &BRANCHES:
  - master
  - my-feature-branch

your_pipeline_job:
  script:
    - echo "分支在允许列表内，执行对应流水线操作"
  only:
    refs:
      *BRANCHES

说明：only/except是GitLab CI早期的过滤语法，目前官方仍保持兼容，但后续新特性优先适配rules体系，如果需要组合多类判断条件，优先选择方案1。

分支较多时的简化写法 #

如果允许列表内的分支数量多，不想写多条if判断，可以用正则匹配的方式简化配置，精确匹配分支名避免误命中：

.allowed_branch_rules: &ALLOWED_BRANCH_RULES
  rules:
    - if: '$CI_COMMIT_BRANCH =~ /^(master|my-feature-branch|feat-.*|release-.*)$/'

your_pipeline_job:
  <<: *ALLOWED_BRANCH_RULES
  script:
    - echo "分支匹配成功，执行对应操作"

后续新增分支只需要在正则的括号内追加分支名，用|分隔即可。

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