如何基于自定义变量实现GitLab流水线作业的自动/手动触发切换？

这个需求我之前也碰到过，GitLab CI的when关键字确实不支持直接写条件表达式，但我们可以用rules来替代它，完美实现基于自定义变量的运行模式切换，下面是两种实用的实现方式：

方法一：用rules按变量条件控制单作业触发时机 #

这是最直接的方案，利用rules支持条件判断的特性，根据RUN_AUTOMATICALLY变量的值决定作业是自动执行还是手动触发：

test-build:
  script:
    - echo "this is just an example"
  rules:
    # 当RUN_AUTOMATICALLY变量为"true"时，作业自动执行
    - if: '$RUN_AUTOMATICALLY == "true"'
      when: on_success
    # 其他所有情况（变量未设置、值不为"true"），作业设为手动触发
    - when: manual

逻辑说明： #

• GitLab CI会按顺序匹配rules中的条件，第一个匹配的规则生效
• 手动触发流水线时，你可以在触发界面的「变量」区域输入RUN_AUTOMATICALLY=true，作业就会自动运行；如果不填这个变量或者填其他值，作业就会变成需要手动点击启动的状态
• 变量引用要用单引号包裹，避免YAML解析时的语法问题，而且GitLab CI中的变量默认是字符串类型，所以要和"true"做字符串比较

方法二：结合workflow控制全局流水线触发模式（可选） #

如果你的需求是让整个流水线的所有作业统一切换模式，也可以在workflow中设置规则，配合变量控制流水线的触发行为：

workflow:
  rules:
    - if: '$RUN_AUTOMATICALLY == "true"'
      # 自动模式下，正常触发流水线
    - when: manual
      # 非自动模式下，整个流水线需要手动确认触发

test-build:
  script:
    - echo "this is just an example"

这种方式适合所有作业都需要统一切换模式的场景，但如果只是部分作业需要控制，还是方法一更灵活。

额外注意事项： #

• 你可以在项目的「设置 → CI/CD → 变量」中设置RUN_AUTOMATICALLY的默认值，比如默认设为false，这样流水线默认是手动模式，需要自动运行时再临时覆盖变量
• 如果是通过API触发流水线，只需要在请求参数中带上variables[RUN_AUTOMATICALLY]=true即可切换到自动模式

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