jenkins+jmeter实现线上巡检

前言：jenkins+jmeter的组合大家肯定都不陌生，持续集成的意义也不必多说，在此给出jenkins+jmeter的经典组合，希望能给正在做或计划做这项工作的童鞋一点帮助。

基本思路：svn维护测试用例.jmx文件及相关参数化文件，jenkins负责调度，jmeter负责执行用例；

 

具体实现步骤如下：

一：安装jenkins

1.前往jenkins官网下载jenkins.war包：https://jenkins.io/download/

2.将下载的Jenkins.war包放入tomcat的webapps下，重启tomcat，在浏览器中输入:服务器IP/jenkins访问，如192.168.9.83:8080/jenkins

按照界面上的提示，找到密码并复制，登录后，安装plugins，首选安装建议plugins，windows下可能会提示无法获取安装，但是点击安装后可以看到tomcat cmd 指令框中在不断下载并安装各种插件。如下图：

linux下，点击安装进入安装界面，如下图：

3.在Global Tool Configuration中配置jdk及ant：

4.在系统设置中配置邮箱（ant也可以发送邮件，但还是在此处设置下邮箱，便于其他场景使用，如构建失败时发送邮件）：

5.另外，在jenkins执行tomcat的.sh文件时，会发现tomcat有启动的过程，但是不会常驻后台，看jenkins输出的日志，发现jenkins在构建结束之后，会杀掉所有未终止的衍生进程。  jenkins在执行构建时会设置一系列环境变量，这些环境变量将被构建衍生出的进程继承。jenkins在杀掉衍生进程的时候会查看进程的环境变量，如果找到它之前设置的环境变量，则将其杀掉。查阅资料发现，有一个简单的方法来避免进程被杀掉：修改jenkins设置的环境变量BUILD_ID的值，从而让jenkins认为此进程不是由Job的构建过程衍生的。如图：

至此jenkins已基本安装及配置完毕，基于它的开放性，jenkins是一款非常强大的集成工具，有很多插件来满足我们的各种需求，在此不做赘述，在实际运用过程中可以百度这些插件的功能及使用方法。

二：ant配置（用于批量执行jmx，生成测试报告并邮件）。

1.安装好ant后，将 jmeter的extras目录中ant-jmeter-1.1.1.jar包拷贝至ant安装目录下的lib目录中，用于ant执行jmx脚本

   将mail.jar及activation.jar放至ant安装目录下的lib目录中，用于ant发送邮件

2. 修改Jmeter的bin目录下jmeter.properties文件的配置：jmeter.save.saveservice.output_format=xml   

3.编写build.xml文件：

<?xml version="1.0" encoding="UTF-8"?>
<project name="jmetertest" default="all" basedir=".">  
    <tstamp>  
        <format property="time" pattern="yyyyMMddhhmm" />  
    </tstamp>  
    <!-- Jmeter 目录-->  
    <property name="jmeter.home" value="/app/apache-jmeter-3.1" /> 
    <!-- 测试结果存放目录 --> 
    <property name="jmeter.result.home" value="/app/tomcat-8.0.22-jenkins-7085/webapps/webDemo01/resultOnline" />
     <!-- jmeter生成jtl格式的结果报告的路径--> 
    <property name="jmeter.result.jtl.dir" value="${jmeter.result.home}/jtl" /> 
    <!-- jmeter生成html格式的结果报告的路径-->
    <property name="jmeter.result.html.dir" value="${jmeter.result.home}/html" />
    <property name="jmeter.result.html.dirDetail" value="${jmeter.result.home}/htmlDetail" />
    <!-- 生成的报告的命名-->  
    <property name="ReportName" value="ParkbeesAPITestReport" />
    <property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}${time}.jtl" />
    <property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}${time}.html" />
    <property name="jmeter.result.htmlNameDetail" value="${jmeter.result.html.dirDetail}/${ReportName}Detail${time}.html" />
	<!--要发送的邮箱地址-->
    <property name="mail_to" value="929152416@qq.com"/>
	<!--<property name="mail_to" value="929152416@qq.com,wuqiuding@ecaray.com,daixu@ecaray.com,chenhongying@ecaray.com"/>-->
    <target name="all">
        <antcall target="test" />
        <antcall target="report" />
		<antcall target="sendEmail"/>
    </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="${jmeter.home}/jmx/online" includes="*.jmx" />
            <property name="jmeter.save.saveservice.output_format" value="xml"/>
        </jmeter>
    </target>
	 <property name="lib.dir" value="${jmeter.home}/lib"/>
     <path id="xslt.classpath">
        <fileset dir="${lib.dir}" includes="xalan*.jar"/>
        <fileset dir="${lib.dir}" includes="serializer*.jar"/>
    </path>
    <target name="report">
	    <tstamp><format property="report.datestamp" pattern="yyyy/MM/dd HH:mm"/></tstamp>
		<!--报告1-->
        <xslt 
	      classpathref="xslt.classpath"
              force="true"
	      in="${jmeter.result.jtlName}"
              out="${jmeter.result.htmlName}"
              style="${jmeter.home}/extras/jmeter-results-detail-report_21.xsl">
	      <param name="dateReport" expression="${report.datestamp}"/>
	</xslt>
		<!--报告2-->
	<xslt 
	      classpathref="xslt.classpath"
              force="true"
	      in="${jmeter.result.jtlName}"
              out="${jmeter.result.htmlNameDetail}"
              style="${jmeter.home}/extras/jmeter.results.shanhe.me.xsl">
		<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>
	<target name="sendEmail">
    <mail 
	       mailhost="smtp.163.com" 
		   mailport="25" 
		   subject="XXX线上巡检报告" 
		   messagemimetype="text/html" 
		   tolist="${mail_to}"
           from="etyero@163.com"
		   user="etyero@163.com"
		   password="XXX"
		   ssl="false">
	<fileset dir="${jmeter.result.html.dir}">
    <include name="${ReportName}${time}.html"/>
    </fileset>
    <fileset dir="${jmeter.result.html.dirDetail}">
    <include name="${ReportName}Detail${time}.html"/>
    </fileset>
    <message>
	以下为本次XXX主流程巡检结果，点击链接(已添加外网映射)查看报告，也可下载附件进行查看。(建议用chrome、firefox等非ie内核浏览器打开):<br />

        PS：如果觉得附件不够方便，可以添加一个外链，这样随时随地都可以访问了，如下：
	报告一（巡检概况）：<br />
        http://www.szkljy.com/webDemo01/resultOnline/html/${ReportName}${time}.html <br />
	报告二（请求及响应详情）：<br />
        http://www.szkljy.com/webDemo01/resultOnline/htmlDetail/${ReportName}Detail${time}.html <br />
   </message>
   </mail>
   </target>
</project>  

4.windows下，管理员cmd运行刚刚的build.xml文件：ant -f build.xml

5.进到build.xml文件中所设置的存放测试结果的目录，查看测试报告：

6.注：如果要使用jmeter.results.shanhe.me.xsl格式，必须要把bin目录下的jmeter.properties配置文件按以下修改：

7.注意：在linux下用ant批量执行jmx文件，需下载jmeter.tgz的包，配置jmeter环境变量：

vim /etc/rpofile，修改完成后source  /etc/profile使其立即生效

另外，如果在linux下发送邮件时，提示：

执行hostname -i，如果没有出现hostname或者IP，说明/etc/hosts里面没有给127.0.0.1对应地址。
解决方法：编辑/etc/hosts，添加 127.0.0.1 ${hostname} （hostname用hostname命令查看），即可正常发送邮件。

至此ant+jmeter的组合已经搭建完成。

以上，巡检所需的基本组件已经配置完毕，接下来就是把他们都串联起来。

三.jenkins+jmeter配置

1.新增自由风格项目，进入项目配置界面

2.以下是我的配置详情：

a.设置构建后工程保留的天数和个数，这个视自身情况而定：

b.我这里没有设置源码管理，因为我直接在发布的.sh文件中写了从svn获取最新源码进行打包及分发到tomcat，以及从svn获取大家提交的jmx文件进行执行：

构建器配置的是每天晚上23:00执行构建，这个时间不是很准确，大概会往后延十几分钟，另外，该构建器还可以支持每隔多少时间执行构建等，详细可以百度或者点击边上的？帮助按钮查看。

c.构建执行的脚本，我这里构建所要做的事情分两步，一步是从svn获取源码打包分发及获取jmx文件；另一步是执行ant的xml文件执行测试。

如果是做线上巡检，则不需要配置从svn获取源码这一步。

d.构建失败则发送邮件到指定邮箱：

至此，所有配置已经完毕。