如何通过Azure Data Factory的Web活动触发Jenkins构建

按照以下优先级逐一排查即可解决问题：

• 首先修正API路径与请求方法
  你当前拼接的接口路径存在错误：Jenkins的/api/json后缀是查询作业元数据的专用路径，不能和构建触发接口混用。无参数触发构建的正确接口格式为https://<替换为你的实际Jenkins地址>/job/path/job_name/build?token=你配置的构建触发token，该接口仅支持POST请求，GET方法调用会被Jenkins直接拒绝。如果触发的是参数化构建，把路径中的build替换为buildWithParameters，构建参数直接拼接在URL query中或放入请求体均可。
  注意检查URL里不要残留示例里的<、>占位符，必须替换为实际的IP/域名，残留特殊字符会直接触发Invalid Url报错。
• 核对集成运行时选型
  报错信息已经明确提示：本地回环地址（localhost/127.0.0.1）仅支持自托管集成运行时：
  • 如果Jenkins部署在本地机房、内网环境，使用私有IP/内网域名访问，绝对不能用ADF默认的Azure托管集成运行时，必须在能正常连通Jenkins的内网机器上安装自托管集成运行时，Web活动关联该自托管IR后再发起调用。
  • 如果Jenkins是公网可访问的服务，确认地址填写完整，HTTPS/HTTP前缀没有遗漏，没有多余的转义字符、空格。
• 排查网络连通性问题
  • 用自托管IR的场景：登录安装IR的服务器，直接在服务器上用curl、浏览器调用你配置的Jenkins接口，确认服务器本身能正常解析Jenkins域名、网络策略（防火墙、安全组、ACL）没有拦截服务器到Jenkins对应端口（默认80/443）的出站请求。
  • 用Azure托管IR的场景：确认Jenkins公网地址的接入防火墙、WAF没有拦截Azure数据中心的出口IP段；如果Jenkins用的是自签名SSL证书，托管IR会因为证书校验失败直接断连，要么换成公开可信CA签发的证书，要么改用自托管IR调用。
• 补全鉴权配置
  大部分Jenkins的安全配置要求双凭据校验：除了URL里拼接的构建触发token，还需要在请求中携带用户身份凭据。在ADF Web活动的身份验证选项中选择「基本身份验证」，用户名填Jenkins的登录用户名，密码填对应用户在Jenkins个人设置页生成的用户API Token（注意和URL里的构建触发token不是同一个凭据，不要混用）。
• 其他边缘场景检查
  如果Jenkins响应较慢，适当调大Web活动的超时时间（默认超时较短，测试时可调整到1~2分钟）；如果内网访问Jenkins需要走代理，要在自托管IR的配置文件中提前配置好代理参数，Azure托管IR不支持自定义网络代理。

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