GitLab触发流水线时CI/CD变量传递失败的问题求助

以下是常见的问题原因及对应解决方法：

1. API请求的变量格式不符合要求 #

GitLab API触发流水线时，变量必须以JSON数组格式传递，而非表单式的variables[TRIGGERED_FROM]键名。这是最容易踩的坑。

正确的curl命令示例：

curl --request POST \
  --header "PRIVATE-TOKEN: <你的访问令牌>" \
  --header "Content-Type: application/json" \
  --data '{
    "ref": "main",
    "variables": [
      {"key": "TRIGGERED_FROM", "value": "deploy.with-modelmesh-crd-upgrades"}
    ]
  }' \
  "https://你的GitLab地址/api/v4/projects/<项目ID>/trigger/pipeline"

注意：变量需包裹在variables数组中，每个变量是包含key和value的对象。

2. 变量的保护状态与触发分支不匹配 #

如果TRIGGERED_FROM被设置为受保护变量，但触发的分支不是项目的受保护分支，变量会被自动过滤，无法注入到流水线中。

解决方法：

• 进入项目「设置」→「CI/CD」→「变量」，取消TRIGGERED_FROM的「受保护」属性；
• 或者确保触发的分支（如main）是项目的受保护分支。

3. 作业rules的条件判断逻辑错误 #

检查被触发作业的rules规则，确保变量引用和比较逻辑正确：

deploy.uninstall-ml-serving-helm-release-and-deploy:
  rules:
    - if: '$TRIGGERED_FROM == "deploy.with-modelmesh-crd-upgrades"'
      when: always

注意点：

• 变量引用必须加$符号；
• 字符串比较的两端需要用双引号包裹（符合YAML语法要求）；
• 避免拼写错误（如变量名大小写、作业名拼写）。

4. 触发API的权限不足 #

用于触发流水线的个人访问令牌需要满足：

• 具备api权限；
• 令牌所属用户拥有项目的开发者及以上权限。

如果权限不足，API可能返回成功状态，但变量无法正常传递，甚至流水线无法创建。可以查看API返回的响应内容，确认是否有权限相关的错误提示。

5. 流水线触发源的规则限制 #

如果被触发作业的rules中包含对CI_PIPELINE_SOURCE的限制，需确保API触发的流水线（CI_PIPELINE_SOURCE值为pipeline）不会被规则拦截。

例如，以下规则会阻止API触发的流水线：

rules:
  - if: '$TRIGGERED_FROM == "deploy.with-modelmesh-crd-upgrades"'
    when: always
  - if: '$CI_PIPELINE_SOURCE == "pipeline"'
    when: never

需调整规则逻辑，确保API触发的场景能匹配到正确的条件。

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