Ubuntu Jenkins怎样配置构建触发器

Ubuntu Jenkins配置构建触发器指南

在Ubuntu系统上配置Jenkins构建触发器，需先确保Jenkins已正确安装并运行（可通过systemctl status jenkins验证服务状态）。以下是常用构建触发器的详细配置步骤及说明：

一、前置准备

安装Jenkins
若未安装Jenkins，可通过以下命令完成安装（需提前安装Java 11+）：

sudo apt update
sudo apt install openjdk-11-jdk
wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
sudo apt update
sudo apt install jenkins
sudo systemctl start jenkins
sudo systemctl enable jenkins

登录Jenkins
打开浏览器访问http://<Ubuntu服务器IP>:8080，输入默认管理员账号（admin）及初始密码（通过sudo cat /var/lib/jenkins/secrets/initialAdminPassword获取）登录。

二、常见构建触发器配置

1. 触发远程构建（Remote Build）

适用场景：通过脚本、CI/CD工具或其他系统远程触发Jenkins构建。
配置步骤：

进入目标Job配置页面，找到“Build Triggers”部分。
勾选Trigger builds remotely (e.g., from scripts)。
设置Authentication Token（自定义令牌，用于验证请求合法性，如my-build-token）。
保存配置后，通过以下URL触发构建（替换<Jenkins_URL>、<Job_Name>和<TOKEN>）：
```
http://<Jenkins_URL>/job/<Job_Name>/build?token=<TOKEN>
```
例如：http://localhost:8080/job/my-job/build?token=my-build-token。
可使用curl或wget命令测试：
```
curl -X POST "http://localhost:8080/job/my-job/build?token=my-build-token"
```

2. 其他工程构建后触发（Build after other projects are built）

适用场景：当依赖的前置Job构建完成（成功/失败/稳定）后，自动触发当前Job。
配置步骤：

进入目标Job配置页面，找到“Build Triggers”部分。
勾选Build after other projects are built。
在“Projects to watch”输入框中填写前置Job名称（如frontend-build），多个Job用逗号分隔。
在“Trigger only if build is stable”选项中选择触发条件：
- 勾选：仅当前置Job构建成功时触发；
- 不勾选：当前置Job构建稳定或不稳定时均触发。
保存配置。

3. 定时构建（Build periodically）

适用场景：按固定时间间隔自动触发构建（如每天凌晨2点、每15分钟一次）。
配置步骤：

进入目标Job配置页面，找到“Build Triggers”部分。
勾选Build periodically。
在“Schedule”输入框中填写Cron表达式（定义构建时间规则）。常见示例：
- H/15 * * * *：每15分钟触发一次（H表示随机分钟，避免多台机器同时构建）；
- 0 0 * * *：每天0点触发一次；
- 0 9-17/2 * * 1-5：工作日（周一至周五）9点至17点之间，每2小时触发一次（如9:00、11:00、13:00等）；
- 0 0 1,15 * *：每月1号和15号0点触发一次。
点击“Schedule”旁的**?**图标可查看Cron表达式语法说明。
保存配置。

4. 轮询SCM（Poll SCM）

适用场景：定期检查代码仓库（Git/SVN）是否有变更，若有变更则触发构建（注意：频繁轮询会增加系统开销，建议优先使用Webhook）。
配置步骤：

进入目标Job配置页面，找到“Build Triggers”部分。
勾选Poll SCM。
在“Schedule”输入框中填写Cron表达式（与定时构建语法一致，如H/5 * * * *表示每5分钟检查一次）。
保存配置。
注意：需提前在“Source Code Management”部分配置代码仓库（如Git），否则轮询无意义。

5. 基于Webhook的事件触发（推荐）

适用场景：当代码仓库发生推送（Push）、拉取请求（PR）等事件时，自动触发Jenkins构建（实时性强，无需频繁轮询）。
以GitHub为例的配置步骤：

步骤1：获取GitHub Token
登录GitHub，进入Settings → Developer settings → Personal access tokens，点击“Generate new token”，勾选repo（仓库权限）、admin:repo_hook（Webhook管理权限），生成Token并保存（如ghp_1234567890abcdef）。
步骤2：配置Jenkins GitHub插件
进入Jenkins“Manage Jenkins → Manage Plugins”，搜索并安装GitHub Plugin。
进入Jenkins“Manage Jenkins → Configure System”，找到“GitHub” section，点击“Add GitHub Server”，输入API URL（https://api.github.com），选择“Secret Text”类型，填写GitHub Token，点击“确定”。
步骤3：配置Job触发器
进入目标Job配置页面，找到“Build Triggers”部分。
勾选GitHub hook trigger for GITScm polling（启用Webhook触发）。
保存配置。
步骤4：配置GitHub Webhook
进入GitHub代码仓库，点击Settings → Webhooks → Add webhook，填写：
- Payload URL：http://<Jenkins_URL>/github-webhook/（Jenkins GitHub插件提供的默认路径）；
- Content type：application/json；
- Secret：可选（与Jenkins中的GitHub Token一致，增强安全性）；
- 选择“Just the push event”（仅推送事件触发）或根据需求选择其他事件；
  点击“Add webhook”。
至此，当仓库发生推送时，GitHub会向Jenkins发送POST请求，自动触发构建。

三、测试构建触发器

远程构建：通过上述URL发送请求，查看Jenkins“Build History”中是否有新构建记录。
其他工程触发：触发前置Job构建，观察目标Job是否按条件启动。
定时/轮询构建：等待设定时间或修改代码仓库内容，查看构建是否自动触发。
Webhook触发：向代码仓库推送代码，查看Jenkins是否收到Webhook请求并启动构建（可在GitHub Webhook页面查看“Recent Deliveries”）。

通过以上配置，可根据项目需求选择合适的构建触发器，实现Jenkins自动化构建。需注意：Webhook触发比轮询SCM更高效，建议优先使用；远程构建需做好权限控制，避免未授权访问。