如综述中所说,Jenkins 主要完成的工作主要是拉取代码后交由 maven,由 maven 完成具体的测试步骤,整个测试过程要用过哪些 Jenkins 的插件和配套环境呢,首先是需要安装 Jenkins 自身 git 和 maven 以及配套的 Jenkins 插件,其次是权限管理插件和邮件发送插件,以及测试要用的性能分析插件和页面保存插件,那么一步一步来吧。
Jenkins 的安装主要方法有两种直接运行 JAR 和放到 Web 容器中,其实都是安装在了家目录的.jenkins 目录下,运行 JAR 包或 war 包后直接按提示下一步操作并设置好管理员用户密码 (下载和如何运行请直接百度)。
进入主界面后首页安装 Jenkins 的全局工具配置,进入系统设置-->全局工具配置
页面,分别把JDK
,Git
,Maven
三个配置项内的路径配置对应的安装路径。
进入系统设置-->管理插件页面
,分别搜索和安装以下插件
插件名 | 作用描述 |
---|---|
Git | 管理 Git |
Role-based Authorization Strategy | 用户及项目权限管理 |
Performance | 解析和展示 Jmeter 性能结果 |
HTML Publisher plugin | 转移保存和展示 HTML 页面 |
Email Extension | 发送构建构建邮件 |
把以上插件都安装好之后,再配置相关选项。如果在安装插件的时候因为长城的问题看不到插件列表,进入插件页面的高级
选项,配置访问代理或把升级站点换成http://mirrors.shu.edu.cn/jenkins//updates/update-center.json
就可以正常访问了。
安装了权限控制插件就可以对角色和项目进行人员的权限控制和访问控制,进入系统设置-->Manage and Assign Roles-->Manage Roles
页面,先进行角色管理,全局角色主要用于全局控制。
项目角色主要用于对项目的分别控制。
配置好角色后返回上一层进入Assign Roles
页面,进行用户配置,用户可以在用户管理
里进行添加。给角色分配不同的权限以达到控制项目和权限的作用。
进入到 Jekins 的首页,点击新建任务
,输入一个任务名后选项自由风格的软件项目,然后点确定。关于项目的命名问题必须规范化,以便控制和管理,如我在这里配置和 Jtest 开头和 Japp 开头的,以便不同的人员只能看到对应的项目。
源码管理配置
,配置对应的 git 仓库,如果是帐号密码访问在高级里配置帐号和密码,如果是密钥访问提前在系统里配置好密钥。
构建触发器
,触发器主要决定了 Jekins 什么情况或什么时候来执行相关测试,这里先简单的配置为定时执行,触发命令参考 Jenkins 帮助,这里的命令为周一到周五每天早上 8 点到晚上 8 点初的第 15 分,每 4 小时执行一次。
构建
,在构建项主要执行的 maven 命令和脚本的选择范围,这里执行的以名字 Hll 开头的脚本,clean 和 install 会清理和安装最新的 JAVA 代码,方便 Jmeter 在调用中使用。
构建后操作
,构建后操作主要作用是测试完成对测试结果进行解析和保存并发送邮件通知,这里一个一个说
性能解析插件
在构建后操作选项里点击添加Publish Performance test result report
步骤,并配置以下相关内容,这个插件主要是把 Jmeter 的结果解析为性能报告。
页面转移和保存插件
在构建后操作选项里点击添加Publish HTML reports
步骤,并配置以下相关内容,这个插件主要是把配置指定路径的页面转移到 Job 里,方便查看。这里可以配置显示上面的性能页面和 Jmeter 自己生成的测试报告(3.0 以后版本支持自己 Jmeter 报告),我这里是显示 Jmeter 自己生成的报告,把路径配置到指定文件夹。这里有个特殊的地方,在上一章配置工程的时候有提过jmeter-maven-plugin
这个插件生成的结果文件夹是有时间格式化的,每次生成路径都会变化,这个功能是在代码里写死的不能配置,所以要稍把原来的功能修改一下,把插件的源代码下载下来修改相应地方的源代码,完成后重新打包用自己的新包就可以用这个功能配合使用来显示 Jmeter 自己生成的报告了。
配置完成后执行后进入对应的页面
进入后这个页面就是显示的是 Jmeter 自己生成的那个性能报告
邮件通知功能
如果要使用邮件插件,必须在系统设置里先设置系统自带的邮件发送管理员设置和插件发送设置
系统管理发送邮件要设置好
插件的邮件发送设置,注意现在很多邮箱的密码是授权码而不是你使用的密码,授权码的获取要对应邮件安全管理里去获取
邮件设置及模板
构建完成后要对构建结果发送对应的项目成员,查看构建结果和测试报告,在构建后操作选项里点击添加Editable Email Notification
步骤,按哪下设置
邮件可以使用模板,现在都是看脸的世界,发出去的邮件也不能太简陋,可以把邮件的模版稍微设计一下,复制到如上图的地方。可以用一些 Jenkins 的环境变量代替邮件的内容,这个收到的邮件的人就可以直接在在邮件里打开报告地址。
这是之前用的一个简单模板,发出去的是这个样子。
有同学要模版,这个是 Jenkins 可以用的构建模版,另一个需要后台服务支持,先不发了,到时候和后台应用一起发
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建结果</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
</head>
<body style="margin: 0; padding: 0;">
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td style="padding: 10px 0 30px 0;">
<table align="center" border="0" cellpadding="0" cellspacing="0" width="600" style="border: 1px solid #cccccc; border-collapse: collapse;">
<tr>
<td align="center" bgcolor="#e5ffff" style="padding: 40px 0 30px 0; color: #153643; font-size: 28px; font-weight: bold; font-family:Microsoft YaHei,Arial, sans-serif;">
<!-- <img src="images/h1.gif" alt="Creating Email Magic" width="300" height="50" style="display: block;" /> -->
<b>自动化测试构建结果</b>
</td>
</tr>
<tr>
<td bgcolor="#ffffff" style="padding: 40px 30px 40px 30px;">
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td style="padding: 20px 0 30px 0; color: #153643; font-family:Microsoft YaHei, Arial, sans-serif; font-size: 24px;">
<b>项目:${PROJECT_NAME}</b>
</td>
</tr>
<tr>
<td style="padding: 20px 0 5px 0; color: #153643; font-family:Microsoft YaHei, Arial, sans-serif; font-size: 16px; line-height: 20px;">
<b>构建结果</b> - ${BUILD_STATUS}
</td>
</tr>
<tr>
<td style="padding: 20px 0 5px 0; color: #153643; font-family:Microsoft YaHei, Arial, sans-serif; font-size: 16px; line-height: 20px;">
<b>构建编号</b> - 第${BUILD_NUMBER}次构建
</td>
</tr>
<tr>
<td style="padding: 20px 0 5px 0; color: #153643; font-family:Microsoft YaHei, Arial, sans-serif; font-size: 16px; line-height: 20px;">
<b>触发原因</b> - ${CAUSE}
</td>
</tr>
<tr>
<td style="padding: 20px 0 5px 0; color: #153643; font-family:Microsoft YaHei, Arial, sans-serif; font-size: 16px; line-height: 20px;">
<b>构建URL</b> - <a href="${PROJECT_URL}">项目构建URL</a>
</td>
</tr>
<tr>
<td style="padding: 20px 0 5px 0; color: #153643; font-family:Microsoft YaHei, Arial, sans-serif; font-size: 16px; line-height: 20px;">
<b>报告明细</b> - <a href="${PROJECT_URL}/PerformanceReport/"><b>明细报告URL</b></a>
</td>
</tr>
<tr>
<td style="padding: 20px 0 5px 0; color: #153643; font-family:Microsoft YaHei, Arial, sans-serif; font-size: 16px; line-height: 20px;">
本邮件为自动化测试构建时的通知,请勿回复。
</td>
</tr>
</table>
</td>
</tr>
<tr>
邮件标签
</tr>
</table>
</td>
</tr>
</table>
</body>
</html>
到这里一个基本的接口自动化框架就可以使用了,剩下的内容我们基于这个框架做一些优化,包括怎么把 Jmeter 的测试结果持久化起来方便汇报查看和回归,怎么用自己的平台独立运行 Jmeter,基于属于一些二次开发的内容。
有同学就发现这邮件发送没有直接的测试结果,还要别人点进去看,而且 Jmeter 的自己的报告也很搓,不直观也很难看,那么下一章我们主要说怎么把 Jmeter 的结果存到数据库,并利用数据库的数据自己收集和整理测试报告,并发送邮件,整理后的报告就可以直接显示结果和错误内容了。