如何基于文件存在性条件触发GitLab Job？解决配置报错

先处理你的配置报错 #

你遇到的jobs:build-image config key may not be used with rules错误，是因为当前Job配置中同时存在rules和与之冲突的关键字（比如only/except）。GitLab CI不允许rules与only/except同时出现在同一个Job里，你需要删除Job中的only/except配置项，仅保留rules。

正确配置：使用内置exists规则 #

不需要自定义CLIENT_EXISTS变量，GitLab CI提供了内置的exists规则，可直接检测仓库中是否存在指定文件，配置简洁且可靠：

build-image:
  stage: build
  script:
    - ... # 你的构建脚本内容
  rules:
    - exists:
        - ./path/to/your/target-file # 替换为你要检测的文件路径，支持通配符如**/*.yaml

补充说明 #

• 路径支持相对仓库根目录的相对路径，也可使用通配符（比如**/Dockerfile匹配所有子目录下的Dockerfile）
• 如果需要结合其他触发条件（比如仅在push触发的流水线中生效），可以给exists添加if约束：

  rules:
    - if: '$CI_PIPELINE_SOURCE == "push"'
      exists:
        - ./path/to/your/target-file
  

• 务必确保Job配置中没有only/except，否则会再次触发冲突报错

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