jmeter+ant+jenkins接口測試及持續集成

此爲Sunny 王苗苗同學的學習筆記，持續學習，持續分享，持續進步，向着大神之路前進~

1、安裝jdk
2、安裝Jmeter
3、安裝Ant
4、安裝Jenkins
5、Jenkins與Ant整合

1、安裝jdk

下載exe文件，一直下一步安裝即可

1）系統變量->新建 JAVA_HOME 變量
變量值輸入jdk的安裝目錄（比如: C:\Program Files\Java\jdk1.8.0_211)
2）系統變量->尋找 Path 變量->編輯
在最後輸入: ;%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin
3）系統變量→新建 CLASSPATH 變量
變量值輸入: .;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar （注意最前面有一點）
檢驗是否配置成功運行cmd 輸入: java –version，如圖所示顯示版本信息，則說明安裝和配置成功。

2、安裝Jmeter

官網：http://jmeter.apache.org/download_jmeter.cgi
直接下載zip包，解壓即可直接使用。
1）系統變量->新建 JMETER_HOME 變量
變量值中輸入: D:\Sunny Wang\apache-jmeter-4.0，即jmeter安裝目錄
2）系統變量->新建CLASSPATH變量
變量值中輸入：
%JMETER_HOME%\lib\ext\ApacheJMeter_core.jar;%JMETER_HOME%\lib\jorphan.jar;
3）系統變量->尋找 Path 變量->編輯
在最後輸入：%JMETER_HOME%\bin
檢驗是否配置成功運行cmd 輸入 jmeter -v ，如圖所示顯示版本信息則說明安裝和配置成功

3、安裝Ant

下載安裝包，解壓即可使用
1）系統變量->新建 ANT_HOME變量
變量值輸入ant的安裝目錄（比如: D:\Sunny Wang\apache-ant-1.9.7)
2）系統變量->尋找 Path 變量->編輯
在最後輸入: ;%ANT_HOME%\bin
進入cmd命令窗口，在CMD窗口中輸入ant -version,敲擊回城鍵，會顯示出你安裝的ANT版本,如果成功顯示，說明你的配置應該是成功了

4、安裝Jenkins

下載war包
1）打開windows命令行窗口，進到jenkins.war所在目錄，輸入java -jar jenkins.war，回車，等待安裝

2）新建一個start.bat文件，輸入如下內容：
echo “Jenkins CI automation testting”
java -jar “D:\Sunny Wang\jenkins\jenkins.war” --httpPort=9091
pause
其中：D:\Sunny Wang\jenkins\jenkins.war是你自己的war包放置地址，注意路徑雙反斜槓。9091端口也可以修改爲其他，後續啓動地址相應修改即可。
3）雙擊start.bat運行，啓動jenkins，有看到Jenkins is fully up and running說明jenkins啓動成功，輸入http://localhost:9091即可打開jenkins的UI界面。
4）找到jenkins初始密碼
打開http://localhost:9091後，按照界面提示打開相應文件，找到初始密碼，一般爲：C:\Users\sunny.wang.jenkins\secrets\initialAdminPassword
5)插件下載
jenkins系統設置->管理插件->可選插件，分別搜索Ant、Email Extension Plugin、
HTML Publisher plugin並立即安裝此插件，其他默認的我也沒去掉，都安裝了。
6）新建個用戶，不建也沒關係

5、Jenkins與Ant整合

將Jmeter目錄下extras子目錄裏的ant-jmeter-1.1.1.jar複製到ant所在目錄lib子目錄之下
修改Jmeter bin目錄下jmeter.properties文件的配置：
jmeter.save.saveservice.output_format=xml
工具文件夾有提供“兩種報告樣式”文件夾，分別其中jmeter.results.shanhe.me.xsl和jmeter-results-detail-report_21_TPS_90%_Received_OK.xsl兩個文件拷貝到Jmeter目錄下extras子目錄裏
在jmeter目錄下新建jmeter_test文件夾，在jmeter_test下新建scripts文件夾，用於存放腳本build.xml
在jmeter_test下新建report文件夾，再在report下新建jtl及html文件夾，用於存放jtl文件及測試報告。
修改build文件內容。你需要準備一個jmeter的jmx文件

示例如下：

<?xml version="1.0" encoding="UTF-8"?>

<project name="ant-jmeter-test" default="run" basedir=".">
    <tstamp>
        <format property="time" pattern="yyyyMMddhhmm" />
    </tstamp>
    <!-- 需要改成自己本地的 Jmeter 目錄-->  
    <property name="jmeter.home" value="D:\Sunny Wang\apache-jmeter-4.0" />
    <!-- jmeter生成jtl格式的結果報告的路徑--> 
    <property name="jmeter.result.jtl.dir" value="D:\Sunny Wang\apache-jmeter-4.0\jmeter_test\report\jtl" />
    <!-- jmeter生成html格式的結果報告的路徑-->
    <property name="jmeter.result.html.dir" value="D:\Sunny Wang\apache-jmeter-4.0\jmeter_test\report\html" />
    <!-- 生成的報告的前綴-->  
    <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}/${ReportName}${time}.html" />
    
    <target name="run">
        <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="D:\Sunny Wang\apache-jmeter-4.0\TEST" includes="unicom.jmx" />
			<property name="jmeter.save.saveservice.output_format" value="xml"/>
        </jmeter>
    </target>
	
    <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" >
			  <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>

設好jenkins全局工具配置
前面jenkins下載的插件下載完成後，進入到系統管理，在全局工具配置中配置jdk及ant，寫上本地的地址即可
設好jenkins系統設置
1、系統設置->Jenkins Locaction項填入Jenkins URL和系統管理員郵件地址，系統管理員郵件地址一定要配置，否則發不了郵件通知。因爲郵件通知都是由系統管理員的郵箱發出來的

2、配置郵箱通知
配置Editable Email Notification ，設置發送的郵件模板

內容模板示例：

<!DOCTYPE html>
<html>

<head>
   <meta charset="UTF-8">
   <title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次構建日誌</title>
</head>

<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4" offset="0">
   <table width="95%" cellpadding="0" cellspacing="0" style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">
       <tr>
           <td>(本郵件是程序自動下發的，請勿回覆！)</td>
       </tr>
       <tr>
           <td>
               <h2> <font color="#0000FF">Hi All,  以下是jmeter接口自動化測試在Jenkins每次構建結果郵件通知！</font> </h2></td>
       </tr>
   	
       <tr>
           <td>
               <br/> <b><font color="#0B610B">構建信息:</font></b>
               <hr size="2" width="100%" align="center" />
           </td>
       </tr>
       <tr>
           <td>
               <ul>
                   <li>項目名稱 ： ${PROJECT_NAME}</li>
                   <li>構建編號 ： 第${BUILD_NUMBER}次構建</li>
                   <li>觸發原因 ： ${CAUSE}</li>                  
                   <li>構建地址 ： <a href="${PROJECT_URL}">${PROJECT_URL}</a></li>
               </ul>
           </td>
       </tr>            
       <tr>
           <td><b><font color="#0B610B">構建結果:</font></b>
               <hr size="2" width="100%" align="center" />
           </td>
       </tr>
   	<tr>
           <td>
                <ul>
   				<li>詳細報告 ： <a href="${PROJECT_URL}HTML_20Report">${PROJECT_URL}HTML_20Report</a> &nbsp;見附件：DetailsReport.html（注意請使用瀏覽器打開！）</li>
   				<li>總體報告 ： <a href="${PROJECT_URL}HTML_20Report">${PROJECT_URL}HTML_20Report</a> &nbsp;見附件：SummaryReport.html（注意請使用瀏覽器打開！）</li>		
               </ul>
           </td>
       </tr>
   	 <tr>
           <td><b><font color="#0B610B">構建日誌 :</font></b>
               <hr size="2" width="100%" align="center" />
           </td>			
       </tr>
   	<tr>
           <td>
                <ul>
   				<li>日誌地址 ： <a href="${BUILD_URL}console">${BUILD_URL}console</a> &nbsp;</li>	
               </ul>
           </td>
       </tr>		
</body>

</html>