Jenkins+JMeter+Ant 接口持续集成

​JMeter安装

JMeter安装包：

• 下载地址：https://jmeter.apache.org/download_jmeter.cgi

• 依赖JDK环境

JDK环境配置：

• JAVA_HOME    E:\jdk1.8.0_51

• CLASSPATH    %JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar;

JMeter配置文件修改

为什么要修改配置文件

• jmeter执行结果文件默认保存的不是xml格式，无法转化成html格式

• jmeter执行结果文件默认有很多执行数据是不保存的，而测试报告需要这些数据

• 配置文件路径 ${jmeterhome}/bin/jmeter.properties

• 配置文件修改内容：修改jtl文件格式：去掉注释（#），修改csv为xml

如果出现如下内容，说明安装成功：

Buildfile: build.xml does not exist!

Build failed

---

Ant相关使用：

定制集成Ant配置文件(bulid.xml)：

具体参看build.xml文件

• <?xml version="1.0" encoding="UTF-8"?>
  
  <project name="ant-jmeter-test" default="all" basedir=".">
  <tstamp>
  <format property="time" pattern="yyyyMMddhhmm" />
  </tstamp>
  <!-- 需要改成自己本地的 Jmeter 目录 -->
  <property name="jmeter.home" value="E:\apache-jmeter-3.2" />
  <!-- jmeter生成jtl格式的结果报告的路径 -->
  <property name="jmeter.result.jtl.dir" value="C:\Users\Administrator\.jenkins\workspace\MiaomiApi\report\jtl" />
  <!-- jmeter生成html格式的结果报告的路径 -->
  <property name="jmeter.result.html.dir" value="C:\Users\Administrator\.jenkins\workspace\MiaomiApi\report\html" />
  <!-- 生成的报告的前缀 htmlm名称与jenkins，HTML directory to archive 设置一致，否则报告会出现404-->
  <property name="ReportName" value="TestReport" />
  <property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}${time}.jtl" />
  <property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/index.html" />
  
  <target name="all">
  <antcall target="test" />
  <antcall target="report" />
  </target>
  
  <target name="test">
  <taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" />
  <jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
  <!-- 声明要运行的脚本。"*.jmx"指包含此目录下的所有jmeter脚本-->
  <testplans dir="E:\ApiTest\jmx" includes="*.jmx" />
  </jmeter>
  </target>
  <!-- 解决html报告中没有日期，以及NAN的问题-->
  <path id="xslt.classpath">
  <fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/>
  <fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/>
  </path>
  
  <target name="report">
  <tstamp> <format property="report.datestamp" pattern="yyyy/MM/dd HH:mm" /></tstamp>
  <xslt
  classpathref="xslt.classpath"
  force="true"
  in="${jmeter.result.jtlName}"
  out="${jmeter.result.htmlName}"
  style="${jmeter.home}/extras/jmeter-results-detail-report_21.xsl">
  <!-- 解决html报告中没有日期的问题-->
  <param name="dateReport" expression="${report.datestamp}"/>
  </xslt>
  
  <!-- 因为上面生成报告的时候，不会将相关的图片也一起拷贝至目标目录，所以，需要手动拷贝 -->
  <copy todir="${jmeter.result.html.dir}">
  <fileset dir="${jmeter.home}/extras">
  <include name="collapse.png" />
  <include name="expand.png" />
  </fileset>
  </copy>
  </target>
  </project>

  如上标注的为路径信息，需要修改为自己的本地路径

• style参数为生成html文件的模板文件，可以修改为自己的模板文件，jmeter提供了多个模板文件可供使用

• 将bulid.xml文件拷贝到：C:\Users\Administrator\.jenkins\workspace\工作目录\ 下

---

Jenkins相关插件介绍与配置：

Jenkins，之前叫做Hudson，是基于Java开发的一种持续集成工具，用于监控持续重复的工作，包括：

1.      持续的软件版本发布/测试项目。

2.      监控外部调用执行的工作。

Jenkins部署：

• 下载地址：https://jenkins.io/index.html

• 下载war包，将jenkins.war文件放入tomcat下的webapps目录下

• 启动tomcat

• 浏览器访问：http://localhost:8080/jenkins

• 新建项目：登录jenkins--新建--输入项目名称--选择：构建一个自由风格的软件项目

Jenkins安装插件：

• 登录jenkins--系统管理--管理插件--可选插件

• 安装：Ant Plugin、HTML Publisher plugin 、Performance plugin插件

---

JMeter插件：Performance plugin

• 功能：用来展示jmeter执行结果

• 配置：jenkins--选择新建的项目--配置--增加构建后操作步骤--Publish Performance test result report--add a new report--选择JMeter--Report files输入： **/*.jtl

配置说明：

• Report files：配置jtl文件路径，相对路径与绝对路径均可，图为相对路径

• 其他选项：配置失败比例显示图形等参数，按需配置

  ---

  Ant插件：Ant plugin

• 功能：用来执行Ant

• 配置如下图：

配置说明：

• Ant Plugin可以在构建步骤中添加，直接执行构建

• Ant Version:在jenkins--系统管理--Global Tool Configuration--ant中维护

Html展示插件：HTML Publisher plugin

• 功能：展示html报告

• 配置截图：

配置说明：

• HTML directory to archive:填写生成html文件的路径（与Ant的 build.xml中设置的保持一致）

• index page[s]:填写展示报告的主页（与Ant的build.xml中设置的保持一致）

• 其他选项：按需填写

原理说明：

• 本插件并不会自己产生html文件，而是通过xslt转化xml生成的报告

• xslt可以自己在服务器中安装，也可以通过通过Ant配置文件指定jar包，本文就是通过Ant指定jmeter内部集成的jar包

• 生成的html文件并不是在jenkins中默认的报告路径展示，而是会复制${jenkinshome}/jobs/projectname/htmlreports/HTML_REPORT 目录下

• 每次只能展示最新版本的html报告，也就是说上一次编译的html报告会被覆盖

• 因为jenkins安全性的问题，默认加载出来的报告是无css的，通过以下配置解决：

• HTML Publisher Plugin 插件在新的Jenkins版本中会导致打开的网页中无法加载CSS以及无法点击按钮的情况， 由于CSP导致，可在Jenkins控制台中执行，jenkins--系统管理--脚本命令行：System.setProperty("hudson.model.DirectoryBrowserSupport.CSP","")以解决此问题。其他由于CSP原因导致的html插件也可用此方法解决

Jenkins配置：

服务器环境与依赖：

• Jdk：安装并配置环境变量

• Ant：安装并配置环境变量

• Jmeter：安装并添加需要的插件

其他：

• Jmeter+Ant，需要将${jmeterhome}/extras/ant-jmeter-1.1.1.jar文件拷贝到${anthome}/lib目录下，否则编译会报错

• Jmeter如需链接数据库，需添加jdbc插件

• 如果不引入jmeter中的xslt，需要手动安装该软件

• Jenkins项目配置：

• jenkins的工作路径，同样的jar包都可能会生成不同的路径。 jenkins--系统设置--系统设置

---

测试执行与报告优化：

测试报告模板：

jmeter自带模板：

• jmeter自带了4个模板（jmeter3后降低为2个）

• 模板路径：${jmeterhome}/extras/jmeter-results*.xsl

• 模板效果（jmeter-result-detail_21.xsl）：

• 修改报告的名称：${jmeterhome}/extras/jmeter-results*.xsl文件中<xsl:param    name="titleReport" select="'MiaomiTestReprot'"/>修改标红部分

第三方模板：

• 下载地址：http://shanhe.me/node/18/314

• 把下载的文件放到jmeter的extras目录下

• 修改jmeter.properties文件如下部分，我这里都修改成true，这样执行完脚本后就会保存这些结果到.jtl文件里面：

第三方模板：

• 下载地址：http://shanhe.me/node/18/314

• 把下载的文件放到jmeter的extras目录下

• 修改jmeter.properties文件如下部分，我这里都修改成true，这样执行完脚本后就会保存这些结果到.jtl文件里面：

jmeter.save.saveservice.data_type=true
jmeter.save.saveservice.label=true
jmeter.save.saveservice.response_code=true
# response_data is not currently supported for CSV output
jmeter.save.saveservice.response_data=true
# Save ResponseData for failed samples
jmeter.save.saveservice.response_data.on_error=false
jmeter.save.saveservice.response_message=true
jmeter.save.saveservice.successful=true
jmeter.save.saveservice.thread_name=true
jmeter.save.saveservice.time=true
jmeter.save.saveservice.subresults=true
jmeter.save.saveservice.assertions=true
jmeter.save.saveservice.latency=true
jmeter.save.saveservice.connect_time=true
jmeter.save.saveservice.samplerData=true
jmeter.save.saveservice.responseHeaders=true
jmeter.save.saveservice.requestHeaders=true
jmeter.save.saveservice.encoding=true
jmeter.save.saveservice.bytes=true
jmeter.save.saveservice.url=true
jmeter.save.saveservice.filename=true
jmeter.save.saveservice.hostname=true
jmeter.save.saveservice.thread_counts=true
jmeter.save.saveservice.sample_count=true
jmeter.save.saveservice.idle_time=true

l  修改build.xml文件，如下style的值修改为新下载的xsl文件名：

• <xslt
                classpathref="xslt.classpath"
                force="true"
  in="${jmeter.result.jtlName}"
  out="${jmeter.result.htmlName}"
                style="${jmeter.home}/extras/jmeter.results.shanhe.me.xsl">
                <param name="dateReport" expression="${report.datestamp}"/>
         </xslt>

  输出的报告如图：

关注微信公众号，自动化测试交流