Jenkins+JMeter+Ant 接口持续集成

  • 2019 年 11 月 13 日
  • 筆記

​JMeter安装

JMeter安装包：

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

  • 依赖JDK环境

JDK环境配置：

  • JAVA_HOME    E:jdk1.8.0_51

  • CLASSPATH    %JAVA_HOME%lib;%JAVA_HOME%libtools.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:UsersAdministrator.jenkinsworkspaceMiaomiApireportjtl" />  <!-- jmeter生成html格式的结果报告的路径 -->  <property name="jmeter.result.html.dir" value="C:UsersAdministrator.jenkinsworkspaceMiaomiApireporthtml" />  <!-- 生成的报告的前缀 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:ApiTestjmx" 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:UsersAdministrator.jenkinsworkspace工作目录 下

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>

     

    输出的报告如图：

 

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

 

VirMach 便宜 VPS

QNews

QNews