平台简介
一个完整的接口自动化测试平台需要支持接口的自动执行,自动生成测试报告,以及持续集成。Jmeter
支持接口的测试,Ant
支持自动构建,而Jenkins
支持持续集成,所以三者组合在一起可以构成一个功能完善的接口自动化测试平台。
环境准备
环境依赖
- JDK环境配置
- Jmeter安装
- Ant安装环境变量配置
- Jenkins安装
Ant简介
Apache Ant,是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具,大多用于Java环境中的软件开发。
下载安装
下载地址:https://ant.apache.org/bindownload.cgi
下载之后解压到任意文件路径,我这里是放到C盘根目录。
环境变量配置
- ANT_HOME C:\apache-ant-1.10.5
- Path : %ANT_HOME%\bin
- ClassPath %ANT_HOME%\lib
配置检测
输入如下命令即可检查是否安装成功
1 | C:\Users\Shuqing>ant -version |
注意:如果提示‘ant不是内部命令也不是外部命令’ 说明环境变量可能配置错误。
Jenkins简介
Jenkins是一个开源软件项目,是基于Java开发的一种持续集成工具,用于监控持续重复的工作,旨在提供一个开放易用的软件平台,使软件的持续集成变成可能。
下载与安装
下载地址:https://jenkins.io/download/
下载后安装到指定的路径即可,默认启动页面为localhots:8080,如果8080端口被占用无法打开,可以进入到jenkins安装目录,找到jenkins.xml
配置文件打开,修改如下代码的端口号即可。
1 | <arguments>-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -jar "%BASE%\jenkins.war" --httpPort=8080 --webroot="%BASE%\war"</arguments> |
平台搭建
依赖文件配置
- 首先在Jmeter目录下面新建一个文件夹
loadTest
(文件夹名称不要使用下划线,空格字符),并将Jemter测试脚本放置到该文件夹中。 - 将Jmeter
extras
文件中的ant-jmeter-1.1.1.jar
放到Ant中的lib
文件夹中 - 将Jmeter
extras
文件中的jmeter-results-detail-report_21.xsl
,build.xml
、collapse.png
、expand.png
放到 ant目录中的bin
目录下面。
build.xml配置
在Ant的bin
目录中打开build.xml
文件找到以下内容1
2
3
4
5
6<property name="testpath" value="${user.dir}"/>
<property name="jmeter.home" value="${basedir}/.."/>
<property name="report.title" value="Load Test Results"/>
<!-- Name of test (without .jmx) -->
<property name="test" value="Test"/>
参数说明
testpath
测试计划,这里用于存放测试脚本、测试生成的文件、测试报告jmeter.home
Jmeter目录路径report.title
测试报告的标题test
jmeter测试脚本的名称(无需后缀.jmx)
这里根据自己的环境修改为
1 | <property name="testpath" value="C:\apache-jmeter-4.0\loadTest"/> |
Ant构建
执行如下命令进行构建
1 | ant -buildfile C:\apache-ant-1.10.5\bin\build.xml |
结果如下:
进入到loadTest
文件夹可以看到生成如下文件:
打开html测试报告httpbin_test.html
报告内容如下:
报告优化
Jmeter默认生成报告不是很详细,因此我们需要进行优化。这里我们使用新的报告模板:jmeter-results-detail-report_30.xsl
默认的报告模板是jmeter-results-detail-report_21
打开 build.xml
将21
改为30
1 | <condition property="style_version" value="_30"> |
补充删除 .jtl
的代码,如果不删除每次迭代的记录都会显示在报告里面,显得很冗余。1
2
3
4<target name="run">
<echo>funcMode = ${funcMode}</echo>
<delete file="${testpath}/${test}.html"/>
<delete file="${testpath}/${test}.jtl"/>
进入Jmeter的bin
目录,找到jmeter.properties
文件打开。然后将以下代码取消注释状态,并改为true
1 | jmeter.save.saveservice.data_type=true |
最后执行即可生成最新的报告:样式如下,可以清晰看到每一个请求发送,响应内容。
注意
如果生成的报告为空,则说明jmeter脚本有错误,此时可以打开jmeter的bin
目录中的jmeter.log
日志文件,查看具体的报错信息。
集成到Jenkins
在Jenkins新建一个任务httpbin_Api_test
在构建选项中选择Invoke Ant
然后在Build File
输入build.xml配置文件路径。注意:不要输入到Targets
里面去了,需要点击高级选项后才可以显示出Build File
执行之后可以看到控制台输出和cmd的控制台输出是一样的
如果想定制构建则可以在构建触发器中选择Build periodically
如果想每个工作日下班18时执行,则可以如下设置:
邮件推送
参考 python 邮件发送
报错相关
1.jtl does not exist
1 | BUILD FAILED |
原因分析
- 写入
.jtl
的目录文件没有写入权限 - 脚本名称和配置不一致,如下面的
value
值名称和jmx
名称不一致
1 | <!-- Name of test (without .jmx) --> |
解决方案
- 将文件夹增加写入权限
- 配置
build.xml
的value
值和jmeter脚本名称一致。 - 打开
jmeter.log
查看其他具体原因
2.生成的报告为空
一般可能脚本运行有错误,比如依赖的文件路径发生了变化。可以打开jmeter.log
查看具体错误原因。
批量运行多个脚本
由于jmeter4.0版本默认提供的build.xml
不支持通配符来批量运行多个脚本,所以这里修改build.xml
配置文件来实现批量执行,具体脚本如下:
1 | <?xml version="1.0" encoding="UTF-8"?> |