如何在GitLab API传入自定义变量并在CI/CD作业中读取解析？

1. 确认POST触发的变量格式 #

你通过curl传入的variables.json必须把参数放在variables字段下，GitLab会自动将这些键值对注入为CI作业的环境变量。示例variables.json结构：

{
  "variables": {
    "ARG1": "first-value",
    "ARG2": "second-value",
    "ARG3": "third-value"
  }
}

2. 在.gitlab-ci.yml中直接调用变量 #

GitLab会自动暴露POST传入的变量作为作业的环境变量，你可以直接在test-job1的脚本里使用这些变量，传递给Python脚本：

test-job1:
  script:
    # 直接将环境变量作为参数传给mydumbscript.py
    - python mydumbscript.py $ARG1 $ARG2 $ARG3

3. 可选：添加参数校验（避免脚本异常） #

如果要确保参数存在，可在脚本开头加入校验逻辑，防止因缺失参数导致作业失败：

test-job1:
  script:
    - |
      # 检查必填参数是否存在
      if [ -z "$ARG1" ] || [ -z "$ARG2" ] || [ -z "$ARG3" ]; then
        echo "Error: 缺少必填参数ARG1、ARG2或ARG3"
        exit 1
      fi
    - python mydumbscript.py "$ARG1" "$ARG2" "$ARG3"

注意：如果参数包含空格或特殊字符，一定要用双引号包裹变量（如"$ARG1"），避免参数被错误拆分。

关键注意事项 #

• 变量名大小写敏感：如果variables.json里用小写arg1，CI环境变量就是$arg1，建议统一用大写变量名，符合GitLab CI的惯例。
• 触发权限：执行curl触发流水线的用户需要拥有项目开发者及以上权限，否则无法传递自定义变量。
• 特殊字符转义：如果参数包含引号、反斜杠等特殊字符，需要在variables.json中正确转义（比如用\"表示双引号）。

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