2. 配置Jenkins自由风格任务
任务说明
在Jenkins中创建一个自由风格项目(Freestyle Project),完成以下三项核心配置:
- 源码管理:从Git仓库拉取代码;
- 构建步骤:执行Shell命令完成构建(以Maven编译打包为例);
- 邮件通知:构建失败时向指定邮箱发送通知。
前置条件
- Jenkins 2.303+ 已安装并启动,管理员账号可登录。
- 已安装插件:Git Plugin、Email Extension Plugin(或内置邮件通知功能)。
- Jenkins服务器可访问目标Git仓库,且已配置好Git凭据(Credentials)。
- 服务器已安装JDK 8+ 和 Maven 3.6+,并已在Jenkins全局工具配置中设置好JDK与Maven路径。
实现步骤
以下通过Jenkins Web界面操作完成配置,无需编写额外代码文件。核心配置路径如下:
1. 创建自由风格任务
- 登录Jenkins → 点击 新建任务(New Item)。
- 输入任务名称,如
demo-freestyle-build。 - 选择 自由风格项目(Freestyle project)→ 点击 确定。
2. 配置源码管理(Git)
- 在任务配置页找到 源码管理(Source Code Management)区域。
- 选择 Git。
- 在 Repository URL 填入Git仓库地址,例如:
https://github.com/your-org/demo-app.git。 - 在 Credentials 下拉框选择已配置的Git凭据(若仓库为公开只读,可选
- none -)。 - Branches to build 默认填写
*/main(根据实际分支修改,如*/master)。
3. 配置构建步骤(Shell + Maven)
- 点击 构建步骤(Build Steps)区域的 增加构建步骤 → 选择 执行 shell(Execute shell)。
- 在命令输入框中填写:
mvn clean package -DskipTests
echo "构建完成,产物目录:target/"
4. 配置邮件通知
- 点击 增加构建后操作步骤(Post-build Actions)→ 选择 邮件通知(Email Notification)。
- 在 收件人(Recipients)中填写邮箱地址,例如:
dev-team@example.com。 - 勾选 每次不稳定的构建都发送邮件(Send email for every unstable build)。
- 勾选 发送针对每个失败的构建的邮件(Send email for every failed build)。
- 若使用Email Extension插件,可选择 可编辑邮件通知(Editable Email Notification),在 项目收件人列表 中填写邮箱,并在 触发器 中勾选 失败(Failure)。
5. 保存并验证
- 点击页面底部 保存(Save)。
- 在任务主页点击 立即构建(Build Now)。
- 观察 构建历史(Build History)区域,等待构建完成。
验证方法与判定标准
| 检查项 | 操作 | 通过条件 |
|---|---|---|
| 源码拉取 | 点击构建编号 → 查看 控制台输出(Console Output) | 日志中出现 Cloning repository 且无Git认证错误 |
| 构建执行 | 查看控制台输出中Maven相关日志 | 出现 BUILD SUCCESS,且日志末尾无报错 |
| 构建产物 | 在Jenkins工作区检查 target/*.jar 或 target/*.war | 产物文件存在且非空 |
| 邮件通知 | 故意在Shell步骤中写入错误命令(如 exit 1),再次构建 | 构建状态为失败,且收件邮箱收到Jenkins发送的失败通知邮件 |
常见问题
- Git拉取失败:检查仓库URL是否正确、凭据是否有效、Jenkins服务器是否能访问该仓库(网络/SSH密钥)。
- Maven命令找不到:确认Jenkins全局工具配置中已设置Maven安装,或在Shell步骤中使用Maven路径(如
/opt/maven/bin/mvn)。 - 邮件未收到:检查Jenkins系统管理 → 系统配置中的SMTP服务器地址、端口、认证信息是否正确;部分邮箱需开启SMTP授权码。