使用CURL提交带大量参数的Jenkins任务不识别自定义参数问题求助
修复方案
原命令存在的问题
- 请求路径错误:
buildWithParameters是Jenkins任务下的专属端点,必须拼接任务路径,正确格式为https://jenkins_URL/job/[你的任务名]/buildWithParameters - 请求配置冲突:同时设置
Content-Type: application/json请求头和--form参数,--form会强制将请求类型改为multipart/form-data,手动设置的JSON头失效,Jenkins无法正常解析参数 - 转义错误:JSON字符串内使用了HTML转义符
\",shell环境下单引号包裹的JSON内容不需要转义双引号 - 存在无效参数:命令末尾的
file://policy.json属于多余参数,会干扰curl请求构造 - 传参格式不符合Jenkins要求:
buildWithParameters端点不需要将参数封装在json表单字段内传递
推荐修复方案(表单传参,更稳定)
直接将参数作为表单字段发送,无需封装JSON,命令如下:
curl -v -X POST \ 'https://jenkins_URL/job/替换为你的任务名/buildWithParameters' \ --user ABC:token \ -F "ACTION=ONBOARD_NEWUSECASE" \ -F "Name=ABC" \ -F "Number=123456789" \ -F "sample=SAMPLE" \ -F "A1=V1" \ -F "A2=V2" \ -F "A3=V3"
可选方案(JSON格式传参)
如果需要用JSON格式传递参数,使用/build端点,命令如下:
curl -v -X POST \ 'https://jenkins_URL/job/替换为你的任务名/build' \ --user ABC:token \ -H "Content-Type: application/json" \ --data '{ "parameter": [ {"name": "ACTION", "value": "ONBOARD_NEWUSECASE"}, {"name": "Name", "value": "ABC"}, {"name": "Number", "value": "123456789"}, {"name": "sample", "value": "SAMPLE"}, {"name": "A1", "value": "V1"}, {"name": "A2", "value": "V2"}, {"name": "A3", "value": "V3"} ] }'
额外注意事项
- 如果你的Jenkins开启了CSRF保护,需要在请求中额外添加Jenkins Crumb请求头:
-H "Jenkins-Crumb: 你的crumb值",可通过命令curl --user ABC:token 'https://jenkins_URL/crumbIssuer/api/json'获取crumb值 - 确认传入的参数名、大小写和Jenkins任务中配置的参数完全一致
内容的提问来源于stack exchange,提问作者Minal G
相关产品推荐
相关产品推荐

