基於Jmeter和Jenkins介面自動化測試框架搭建詳細過程
1. 下載地址
Jmeter: http://jmeter.apache.org/download_jmeter.cgi
Ant:http://ant.apache.org/bindownload.cgi
Jenkins:https://jenkins.io/index.html
2. Jmeter+Ant安裝配置
- Jmeter解壓後執行Jmeter.bat即可使用
- Ant下載後解壓到目錄,按照下列配置系統變數即可:
1) ANT_HOME:D:\apache-ant-1.9.4-bin\apache-ant-1.9.4(此為ANT安裝路徑)
2) PATH(後面新增以下內容):;%ANT_HOME%\bin
3) 測試Ant:在CMD中輸入ant –version,如果返回ant版本,則表示安裝成功
- 將JMeter目錄下extras子目錄裡ant-JMeter-1.1.1.jar複製到Ant的lib目錄下,這樣Ant執行時才能找到,"org.programmerplanet.ant.taskdefs.jmeter.JMeterTask"這個類,從而成功觸發JMeter指令碼。
- jmeter預設儲存的是.csv格式的檔案,所以我們先要設定一下bin/jmeter.properties檔案內容,儲存
jmeter.save.saveservice.output_format=xml
- 配置ant構建檔案build.xml(見附錄)
3. Jenkins安裝與配置
Jenkins安裝比較簡單,點選msi檔案按照要求操作即可,過程若出現問題,可重啟下jenkins服務後,再繼續安裝;
接下來主要介紹Jenkins構建ant專案的配置:
瀏覽器輸入地址http://localhost:8080/顯示介面,則表示安裝成功
4. shell執行環境搭建
安裝cygwin後,配置環境變數
l 按照下列配置系統變數即可:
1) JAVA_HOME:D:\ Program Files\Java\jdk1.8.0_11(此為JDK安裝路徑)
2) ANT_HOME:D:\apache-ant-1.9.4-bin\apache-ant-1.9.4(此為ANT安裝路徑)
3) PATH(後面新增以下內容):
;%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;%ANT_HOME%\bin;E:\Program Files\cygwin\bin
4) 測試Ant:在CMD中輸入ant –version,如果返回ant版本,則表示安裝成功
5) 測試Java:在CMD中輸入 java –version,如果返回java版本,則表示安裝成功
6) 測試shell執行環境:在CMD中輸入sh,如果為提示錯誤,則表示安裝成功
5. Testlink與Jenkins對接
1、先安裝過程所需要的外掛:Testlink Plugin、TAP Plugin
直接在系統管理—>管理外掛—>可選外掛,中搜索後,點選安裝即可
注意:TAP外掛必須用1.25版本的,新版本釋出後tap檔案連結失效
2、 系統管理—>系統設定,Testlink配置如下:
Name:TestLink 1.9.10
URL:http://192.168.4.56/testlink/lib/api/xmlrpc/v1/xmlrpc.php
Developer Key:登入TestLink後,選擇個人賬號—生成新的祕鑰,API Key拷貝到這裡即可
6. TestLink配置
Testlink需要增加自定義欄位,如AutoTest,具體的用例如下:
注意兩點:
1)測試方式:自動的
2)AutoTest:內容為對應該條用例的.tap檔案的檔名
7. 構建專案
7.1. 準備測試指令碼到SVN
上圖是SVN中對應的檔案結構,下面會介紹jenkins構建專案的詳細配置。
7.2. 新建一個自由風格的軟體專案
舊的構建儲存了你在一次構建中的所有臨時檔案,如果構建沒有保留的必要,就勾選丟棄舊的構建,同時設定保持構建天使和保持構建的最大個數兩個引數。注意:三個設定必須同時設定,否則無效
7.3. 原始碼管理
選擇subversion
Repository URL:SVN中指令碼目錄
Credentials:SVN賬號使用者名稱和密碼,可點選後面的Add新增
Local module directory:SVN下載到本地的目錄,配置為【.】預設專案根目錄下【注:這個與Ant的build.xml檔案中的配置相關聯,預設的檔案是根目錄,若這裡有修改,需要修改對應的build.xml檔案】
7.4. 觸發器配置
這裡是讓指令碼每天晚上自動構建執行,若不需要重複執行,則不要勾選該項介面
7.5. 構建Invoke TestLink
注:
1、 TestLink Configuration中TestProjectName和TestPlan Name需要與testlink中的【測試專案】和測【測試計劃】一致
2、 TestLink Configuration中BuildName:
1) 可以與Testlink設定一致(這樣每次測試結果會在同一個測試版本中記錄多次結果)
2) 也可以設定由Jenkins配置返回,如:上圖中的$BUILD_TAG,則表示將構建這次專案的標記作為版本返回到TestLink上,這樣每一次構建,Testlink上都會新增一個版本
3、 Targets:這裡是指build.xml檔案中的<target name=“xxx”>,可設定為空,則預設全部執行
4、 這裡的Build File是指Ant的build.xml所在目錄,若前面SVN目錄有修改,這裡也需要一併修改
5、 After iterating all test cases Build Steps:這裡執行jmx.sh檔案,將Jmeter執行結果XML格式,轉換為TAP格式,以便TestLink轉換為測試結果
這個配置是將TAP結果返回到Testlink,
注意:
Include Pattern:這裡的路徑與build.xml檔案中輸出的路徑一致。
7.6. TAP結果釋出
Test results:結果路徑配置,與build.xml中配置輸出路徑一致
7.7. 構建後郵件傳送
增加構建後操作:Editable Email Notification
7.8. 系統配置:郵件的全域性引數配置
未截圖的按預設配置
備註:
Default Subject:用例執行結果:$PROJECT_NAME - Build # $BUILD_NUMBER - $BUILD_STATUS!
Default Content:
${FILE,path="sum/sum.html"}<hr/> (本郵件是程式自動下發的,請勿回覆!)<br/> 專案名稱:$PROJECT_NAME<br/> 構建編號:$BUILD_NUMBER<br/> svn版本號:${SVN_REVISION}<br/> 構建狀態:$BUILD_STATUS<br/> 觸發原因:${CAUSE}<br/> 構建日誌地址:<a href="${BUILD_URL}console">${BUILD_URL}console</a><br/><hr/> 構建地址:<a href="$BUILD_URL">$BUILD_URL</a><br/><hr/> 變更集:${JELLY_SCRIPT,template="html"}<br/><hr/>
郵件通知配置,根據郵箱實際情況進行配置即可,如下:
8.附錄
JMX2TAP.SH內容:
1 #!/bin/bash 2 LANG=zh_CN.UTF-8 3 export LANG 4 # Parse each result file from the tests, created by JMeter when run by ant. 5 # Every file created by JMeter will be parsed consecutively by the following for loop. 6 for XML_resultfile in $(ls -1 results/*.xml); do 7 echo "XML_resultfile: ${XML_resultfile}" 8 BASE_filename=$(basename ${XML_resultfile} .xml) 9 TestSamples=( $(xpath ${XML_resultfile} '//@lb' 2>/dev/null) ) 10 num_of_TestSamples=${#TestSamples[@]} 11 echo "num_of_TestSamples: ${num_of_TestSamples}" 12 # Reference to TAP13 file standard: 13 # link:http://www.4pan.net 14 # result_selector=0 15 if [ ${num_of_TestSamples} -gt 0 ]; then 16 for ((line=0; ${line} < ${num_of_TestSamples}; line++)); do 17 echo "------------------CASE ${line}--------------------------" 18 echo "TestCases fullname: ${TestSamples[${line}]}" 19 isFlag=$( echo ${TestSamples[${line}]} | grep '.*-.*-.*(.\{1,\}):.*') 20 if [ "${isFlag}" != "" ]; then 21 filename=$( echo ${TestSamples[${line}]} | cut -d '"' -f 2 | cut -d '(' -f 1 ) 22 TAP_filename=${filename}.tap 23 isExistTap="" 24 isExistTap=$(ls -R | grep "${TAP_filename}") 25 if [ "${isExistTap}" == "" ]; then 26 TestCase=$( echo ${TestSamples[${line}]} | cut -d '"' -f 2 | cut -d ':' -f 1 ) 27 num_of_testcases=1 28 TestCase_count1=( $(xpath ${XML_resultfile} "//httpSample[contains(@lb,'${filename}')]/@rc" 2>/dev/null) ) 29 TestCase_count2=( $(xpath ${XML_resultfile} "//sample[contains(@lb,'${filename}')]/@rc" 2>/dev/null) ) 30 ((num_of_testcases=${#TestCase_count1[@]}+${#TestCase_count2[@]})) 31 echo "TestCase:${TestCase}" 32 echo "filename:${TAP_filename}" 33 echo "TestCase_count:${num_of_testcases}" 34 label="${BASE_filename} - ${TestCase}" 35 echo "TAP version 13" > results/${TAP_filename} 36 echo ">>>${BASE_filename}.xml Covert to : ${TAP_filename}" 37 echo "1..${num_of_testcases}" >> results/${TAP_filename} 38 # Create an array with testcases labels and results 39 result_if1=( $(xpath ${XML_resultfile} "//httpSample[contains(@lb,'${filename}')]/assertionResult[failure='true']/failure" 2>/dev/null | tr -d '"' | tr ' ' '_' | sed 's/^_//') ) 40 result_if2=( $(xpath ${XML_resultfile} "//sample[contains(@lb,'${filename}')]/assertionResult[failure='true']/failure" 2>/dev/null | tr -d '"' | tr ' ' '_' | sed 's/^_//') ) 41 ((num_of_resultif_count=${#result_if1[@]}+${#result_if2[@]})) 42 echo ">TestResult:${num_of_resultif_count}" 43 #echo "number_result_if:${#result_if[@]}" 44 if [ ${num_of_resultif_count} -gt 0 ]; then 45 msg_texts=( $(xpath ${XML_resultfile} "//httpSample[contains(@lb,'${filename}')]/assertionResult[failure='true']/failureMessage" 2>/dev/null | tr -d '"' | tr ' ' '_' | sed 's/^_//') ) 46 result="not ok ${num_of_testcases} ${label} - error[${num_of_resultif_count}]" 47 echo "${result}">> results/${TAP_filename} 48 echo "failureMessage:${msg_texts}">> results/${TAP_filename} 49 #echo "${result}" 50 #echo "failureMessage:${msg_texts}" 51 #(( line=${line}+${num_of_testcases}-1 )) 52 #echo "msg_text:${msg_texts}">> results/${TAP_filename} 53 #num_of_msg_texts=${#msg_texts[@]} 54 #echo "num_of_msg_texts:${num_of_msg_texts}" 55 #echo "num_of_msg_texts:${msg_texts}" 56 #for ((msgnum=0; ${msgnum} <${num_of_msg_texts}; msgnum++)); do 57 #msg_text="message[${num}]:'$(echo ${msg_texts[${msgnum}]}| cut -d '>' -f 2 | cut -d '<' -f 1)'" 58 #echo "${msg_texts}" 59 #done 60 else 61 if [ ${num_of_testcases} -gt 0 ]; then 62 result="ok ${num_of_testcases} ${label} - error[${#result_if[@]}]" 63 echo "${result}">> results/${TAP_filename} 64 #echo "${result}" 65 #(( line=${line}+${num_of_testcases}-1 )) 66 else 67 result="not ok 1 - ${num_of_testcases} ${label} - error[XML Covert to TAP ERROR:Xpath query find 0 result]" 68 echo "${result}">> results/${TAP_filename} 69 #echo "${result}" 70 #(( line=${line}+${num_of_testcases} )) 71 fi 72 fi 73 else 74 echo ">tap already converted" 75 fi 76 else 77 echo "sample name is not standard" 78 fi 79 done 80 else 81 echo "over" >> results/${TAP_filename} 82 fi 83 doneView Code
build.xml內容
1 <?xml version="1.0" encoding="UTF-8"?> 2 <project name="ant-jmeter-test" default="run" basedir="."> 3 <tstamp> <format property="time" pattern="yyyyMMddhhmm" /> </tstamp> 4 <tstamp> <format property="report.datestamp" pattern="yyyy/MM/dd HH:mm" /></tstamp> 5 <property environment="env"/> 6 <property name="report.title" value="介面測試"/> 7 <property name="jmeter.home" value="${env.JMETER_HOME}" /><!-- 需要改成自己本地的 Jmeter 目錄--> 8 <property name="jmeter.result.dir" value="${env.WORKSPACE}/results" /><!-- jmeter測試結果放置目錄,這裡是放在構建專案下的result目錄--> 9 <property name="jmeter.sum.dir" value="${env.WORKSPACE}/sum" /><!-- jmeter測試概要放置目錄(主要用於郵件傳送時,作正文內容),這裡是放在構建專案下的result目錄--> 10 <property name="testplan.dir" value="${env.WORKSPACE}" /><!-- 執行的jmx指令碼目錄--> 11 12 13 <property name="ReportName" value="TestReport" /><!-- 生成的報告的字首 --> 14 <property name="jmeter.result.jtlName" value="${jmeter.result.dir}/${ReportName}.xml" /><!-- 生成的jtl報告名稱 --> 15 <property name="jmeter.result.htmlName" value="${jmeter.result.dir}/${ReportName}.html" /><!-- 生成的html報告名稱綴 --> 16 <property name="jmeter.sum.htmlName" value="${jmeter.sum.dir}/sum.html" /> <!-- 生成的sum報告的名稱 --> 17 18 <target name="run"> 19 <echo message="start..."/> 20 <antcall target="clean" /> 21 <antcall target="test" /> 22 <antcall target="report" /> 23 </target> 24 <target name="clean"> 25 <delete dir="${env.WORKSPACE}/results/" /> 26 <mkdir dir="${env.WORKSPACE}/results" /> 27 <delete dir="${env.WORKSPACE}/sum/" /> 28 <mkdir dir="${env.WORKSPACE}/sum" /> 29 </target> 30 <target name="test"> 31 <taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" /> 32 <jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}"> 33 <!-- 宣告要執行的指令碼。"*.jmx"指包含此目錄下的所有jmeter指令碼 --> 34 <!-- 配置構建引數TESTLINK_TESTCASE_TESTFILEPATH在Jenkins上 --> 35 <!-- ant -DGUI=false -DTEST_ENVIRONMENT=2 -DTESTLINK_TESTCASE_TESTFILEPATH=test.jmx --> 36 <testplans dir="${testplan.dir}" includes="${env.TESTLINK_TESTCASE_TESTFILEPATH}.jmx" /> 37 <property name="jmeter.save.saveservice.output_format" value="xml"/> 38 <property name="jmeter.save.saveservice.assertion_results" value="all"/> 39 <property name="jmeter.save.saveservice.bytes" value="true"/> 40 </jmeter> 41 </target> 42 <path id="xslt.classpath"> 43 <fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/> 44 <fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/> 45 </path> 46 47 <target name="report"> 48 49 <xslt classpathref="xslt.classpath" 50 force="true" 51 in="${jmeter.result.jtlName}" 52 out="${jmeter.result.htmlName}" 53 style="${jmeter.home}/extras/jmeter.results.shanhe.me.xsl"> <!-- jtl測試報告轉化為html報告 --> 54 <param name="dateReport" expression="${report.datestamp}"/> 55 </xslt> 56 <xslt classpathref="xslt.classpath" 57 force="true" 58 in="${jmeter.result.jtlName}" 59 out="${jmeter.sum.htmlName}" 60 style="${jmeter.home}/extras/jmeter-results-detail-report_21-lj.xsl"> <!-- sum.html報告,該xsl檔案在上個檔案的body中保留summary部分的顯示,用於jenkins構建後郵件傳送的正文展示 --> 61 <param name="dateReport" expression="${report.datestamp}"/> 62 </xslt> 63 <!-- 因為上面生成報告的時候,不會將相關的圖片也一起拷貝至目標目錄,所以,需要手動拷貝 --> 64 <copy todir="${jmeter.result.dir}"> 65 <fileset dir="${jmeter.home}/extras"> 66 <include name="collapse.png"/> 67 <include name="expand.png"/> 68 </fileset> 69 </copy> 70 </target> 71 </project> 72View Code