如何仅当工具返回退出码0时向GitLab流水线添加任务？

问题场景 #

需要在GitLab流水线中配置集成测试任务，仅当项目存在指定的Maven Profile（如IT）时，该任务才会被纳入流水线。当前实现是始终添加任务，通过脚本判断后跳过执行，容易让流水线查看者误以为任务已执行，需要更优方案。

最优实现方案 #

利用GitLab CI的rules:script特性，通过执行检查命令的退出码来决定是否将任务加入流水线。只有当检查命令返回退出码0时，任务才会被创建。

配置示例 #

integration-test-job:
  stage: build
  rules:
    - script:
        - mvn help:all-profiles | grep -q "Profile Id: IT"
      when: always
      allow_failure: false
  script:
    - mvn -P IT clean install

配置说明 #

• rules:script：执行检查Maven Profile是否存在的命令，grep -q会静默执行，找到匹配项时返回0，否则返回非0
• allow_failure: false：确保检查命令失败时，任务不会被加入流水线
• 当检查通过时，任务会正常执行mvn -P IT clean install命令；检查不通过时，该任务不会出现在流水线中，避免误解

低版本兼容方案 #

如果使用的GitLab版本低于15.9（rules:script在15.9版本引入），可以使用before_script结合退出命令的方式，虽然任务会显示但会直接失败终止，相对原方案更清晰：

integration-test-job:
  stage: build
  before_script:
    - mvn help:all-profiles | grep -q "Profile Id: IT" || exit 1
  script:
    - mvn -P IT clean install

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