jenkins脚本触发部署

xixingzhe22025-09-14 23:06

1、准备工作

确保 Jenkins 已安装并启用 API 访问
创建 Jenkins 用户并赋予适当权限
生成 API 令牌（在用户设置中创建）

生成API令牌

登录该用户后，进入 个人设置（右上角用户名 → Configure）。
在 API Token 栏点击 Add new Token ，输入名称（如 deploy-token）并生成，保存令牌（仅显示一次）。

生成token

2、触发方式

使用 HTTP POST 请求调用 Jenkins 构建 API
可以传递参数化构建所需的参数
支持通过 Basic Auth 或 API 令牌进行身份验证

脚本示例

复制代码

#!/bin/bash

# Jenkins配置
JENKINS_URL="http://your-jenkins-server:8080"
JOB_NAME="your-deployment-job"
USERNAME="your-username"
API_TOKEN="your-api-token"

# 构建参数（如果有）
PARAMS="ENV=production&VERSION=1.0.0"

# 触发构建
echo "Triggering Jenkins job: $JOB_NAME"
curl -X POST "${JENKINS_URL}/job/${JOB_NAME}/buildWithParameters?${PARAMS}" \
  --user "${USERNAME}:${API_TOKEN}" \
  -H "Content-Type: application/x-www-form-urlencoded"

echo "Build triggered successfully"

关键参数说明

构建 URL：
- 非参数化构建：http://jenkins-url/job/job-name/build
- 参数化构建：http://jenkins-url/job/job-name/buildWithParameters?param1=value1&param2=value2
身份验证：
- 使用用户名:API令牌进行 Basic Auth 认证
- API 令牌可在 Jenkins 个人设置中生成，比密码更安全
响应处理：
- 成功触发会返回 201 Created 状态码
- 可通过 API 查询构建状态：http://jenkins-url/job/job-name/lastBuild/api/json

`示例脚本`

无参数构建

复制代码

#!/bin/bash

# Jenkins配置
JENKINS_URL="http://127.1.0.1:8900"
JOB_NAME="all-sx"
USERNAME="jenkins"
API_TOKEN="11e92e4fffdfbb8d3e7fb247ba9aaaa"


# 触发构建
echo "Triggering Jenkins job: $JOB_NAME"
curl -X POST "${JENKINS_URL}/job/${JOB_NAME}/build" \
  --user "${USERNAME}:${API_TOKEN}" \
  -H "Content-Type: application/x-www-form-urlencoded"

echo "Build triggered successfully"