2. 配置Jenkins自由风格任务

任务说明

在Jenkins中创建一个自由风格项目(Freestyle Project),完成以下三项核心配置:

  1. 源码管理:从Git仓库拉取代码;
  2. 构建步骤:执行Shell命令完成构建(以Maven编译打包为例);
  3. 邮件通知:构建失败时向指定邮箱发送通知。

前置条件

  • Jenkins 2.303+ 已安装并启动,管理员账号可登录。
  • 已安装插件:Git Plugin、Email Extension Plugin(或内置邮件通知功能)。
  • Jenkins服务器可访问目标Git仓库,且已配置好Git凭据(Credentials)。
  • 服务器已安装JDK 8+ 和 Maven 3.6+,并已在Jenkins全局工具配置中设置好JDK与Maven路径。

实现步骤

以下通过Jenkins Web界面操作完成配置,无需编写额外代码文件。核心配置路径如下:

1. 创建自由风格任务

  1. 登录Jenkins → 点击 新建任务(New Item)。
  2. 输入任务名称,如 demo-freestyle-build。
  3. 选择 自由风格项目(Freestyle project)→ 点击 确定。

2. 配置源码管理(Git)

  1. 在任务配置页找到 源码管理(Source Code Management)区域。
  2. 选择 Git。
  3. 在 Repository URL 填入Git仓库地址,例如:https://github.com/your-org/demo-app.git。
  4. 在 Credentials 下拉框选择已配置的Git凭据(若仓库为公开只读,可选 - none -)。
  5. Branches to build 默认填写 */main(根据实际分支修改,如 */master)。

3. 配置构建步骤(Shell + Maven)

  1. 点击 构建步骤(Build Steps)区域的 增加构建步骤 → 选择 执行 shell(Execute shell)。
  2. 在命令输入框中填写:
mvn clean package -DskipTests
echo "构建完成,产物目录:target/"

4. 配置邮件通知

  1. 点击 增加构建后操作步骤(Post-build Actions)→ 选择 邮件通知(Email Notification)。
  2. 在 收件人(Recipients)中填写邮箱地址,例如:dev-team@example.com。
  3. 勾选 每次不稳定的构建都发送邮件(Send email for every unstable build)。
  4. 勾选 发送针对每个失败的构建的邮件(Send email for every failed build)。
  5. 若使用Email Extension插件,可选择 可编辑邮件通知(Editable Email Notification),在 项目收件人列表 中填写邮箱,并在 触发器 中勾选 失败(Failure)。

5. 保存并验证

  1. 点击页面底部 保存(Save)。
  2. 在任务主页点击 立即构建(Build Now)。
  3. 观察 构建历史(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授权码。