GitLab CI报错‘rules:rule exists应为字符串数组’的解决方法

问题原因 #

你当前的rules:exists语法结构错误，误用了paths数组指定文件路径。GitLab CI中，当需要检查外部项目的文件是否存在时，exists需定义为包含对象的数组，每个对象通过path（单数）字段指定文件路径，搭配project参数指向目标项目。

修正后的配置代码 #

packages.react:
  stage: app-build
  needs:
    - project: $UPSTREAM_PROJECT_PATH
      job: get-source-files
      ref: $UPSTREAM_BRANCH_REF
      artifacts: true
  rules:
    - exists:
        - path: package.json
          project: $UPSTREAM_PROJECT_PATH
          ref: $UPSTREAM_BRANCH_REF  # 可选，指定上游项目的分支/标签，确保与流水线ref匹配
  image: $NODE_IMAGE
  script:
    - npm install --frozen-lockfile
    - npm run build

额外注意事项 #

• 版本要求：rules:exists支持检查外部项目文件的特性仅在GitLab 15.10及以上版本可用，若你的GitLab版本低于此，无法使用该语法。
• 低版本替代方案：若GitLab版本不满足要求，可调整为在任务启动后判断文件是否存在：

  packages.react:
    stage: app-build
    needs:
      - project: $UPSTREAM_PROJECT_PATH
        job: get-source-files
        ref: $UPSTREAM_BRANCH_REF
        artifacts: true
    image: $NODE_IMAGE
    script:
      - if [ ! -f package.json ]; then exit 0; fi  # 不存在则直接退出，不执行后续步骤
      - npm install --frozen-lockfile
      - npm run build
  

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