如何在GitLab CI YAML中通过变量动态设置when属性值

直接写when: $VARIABLE不生效，通常和变量引用的语法细节、变量配置或有效值范围有关，以下是两种可行的解决方式：

方法一：直接正确引用变量 #

首先确保VARIABLE的取值是GitLab CI允许的when有效值（包括on_success、on_failure、always、manual、delayed、never），然后修改YAML写法为：

job1:
  stage: stage1
  script: echo "something"
  when: "$VARIABLE"

用双引号包裹变量可以避免YAML解析时的潜在问题，同时要确认变量已在项目/组设置中配置，或在流水线触发时通过参数传递。

方法二：用rules实现灵活分支控制 #

如果需要根据变量值做分支判断，或者兼容更多场景，推荐用rules替代直接设置when：

job1:
  stage: stage1
  script: echo "something"
  rules:
    - if: '$VARIABLE == "on_success"'
      when: on_success
    - if: '$VARIABLE == "manual"'
      when: manual
    - if: '$VARIABLE == "always"'
      when: always
    # 可添加默认规则，比如变量未设置时的默认执行时机
    - when: on_success

这种方式能明确控制不同变量值对应的执行逻辑，也更容易排查问题。

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