1. 下載地址
Jmeter: http://jmeter./download_jmeter.cgi
Ant:http://ant./bindownload.cgi
Jenkins:https:///index.html
2. Jmeter+Ant安裝配置
- Jmeter解壓后運行Jmeter.bat即可使用
- Ant下載后解壓到目錄,按照下列配置系統(tǒng)變量即可:
1) ANT_HOME:D:\apache-ant-1.9.4-bin\apache-ant-1.9.4(此為ANT安裝路徑)
2) PATH(后面添加以下內(nèi)容):;%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"這個類,,從而成功觸發(fā)JMeter腳本,。
- jmeter默認保存的是.csv格式的文件,,所以我們先要設置一下bin/jmeter.properties文件內(nèi)容,,保存
jmeter.save.saveservice.output_format=xml
- 配置ant構(gòu)建文件build.xml(見附錄)
3. Jenkins安裝與配置
Jenkins安裝比較簡單,點擊msi文件按照要求操作即可,,過程若出現(xiàn)問題,,可重啟下jenkins服務后,再繼續(xù)安裝,;
接下來主要介紹Jenkins構(gòu)建ant項目的配置:
瀏覽器輸入地址http://localhost:8080/顯示界面,,則表示安裝成功
4. shell運行環(huán)境搭建
安裝cygwin后,,配置環(huán)境變量
l 按照下列配置系統(tǒng)變量即可:
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(后面添加以下內(nèi)容):
;%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運行環(huán)境:在CMD中輸入sh,,如果為提示錯誤,,則表示安裝成功
5. Testlink與Jenkins對接
1、先安裝過程所需要的插件:Testlink Plugin,、TAP Plugin
直接在系統(tǒng)管理—>管理插件—>可選插件,,中搜索后,點擊安裝即可
注意:TAP插件必須用1.25版本的,,新版本發(fā)布后tap文件鏈接失效
2,、 系統(tǒng)管理—>系統(tǒng)設置,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:內(nèi)容為對應該條用例的.tap文件的文件名
7. 構(gòu)建項目
7.1. 準備測試腳本到SVN
上圖是SVN中對應的文件結(jié)構(gòu),,下面會介紹jenkins構(gòu)建項目的詳細配置。
7.2. 新建一個自由風格的軟件項目
舊的構(gòu)建保存了你在一次構(gòu)建中的所有臨時文件,,如果構(gòu)建沒有保留的必要,,就勾選丟棄舊的構(gòu)建,同時設置保持構(gòu)建天使和保持構(gòu)建的最大個數(shù)兩個參數(shù),。注意:三個設置必須同時設置,,否則無效
7.3. 源碼管理
選擇subversion
Repository URL:SVN中腳本目錄
Credentials:SVN賬號用戶名和密碼,可點擊后面的Add添加
Local module directory:SVN下載到本地的目錄,,配置為【.】默認項目根目錄下【注:這個與Ant的build.xml文件中的配置相關聯(lián),,默認的文件是根目錄,若這里有修改,,需要修改對應的build.xml文件】
7.4. 觸發(fā)器配置
這里是讓腳本每天晚上自動構(gòu)建執(zhí)行,,若不需要重復執(zhí)行,則不要勾選該項接口
7.5. 構(gòu)建Invoke TestLink
注:
1,、 TestLink Configuration中TestProjectName和TestPlan Name需要與testlink中的【測試項目】和測【測試計劃】一致
2,、 TestLink Configuration中BuildName:
1) 可以與Testlink設置一致(這樣每次測試結(jié)果會在同一個測試版本中記錄多次結(jié)果)
2) 也可以設置由Jenkins配置返回,如:上圖中的$BUILD_TAG,則表示將構(gòu)建這次項目的標記作為版本返回到TestLink上,,這樣每一次構(gòu)建,,Testlink上都會新增一個版本
3、 Targets:這里是指build.xml文件中的<target name=“xxx”>,可設置為空,,則默認全部執(zhí)行
4,、 這里的Build File是指Ant的build.xml所在目錄,,若前面SVN目錄有修改,這里也需要一并修改
5,、 After iterating all test cases Build Steps:這里運行jmx.sh文件,,將Jmeter運行結(jié)果XML格式,轉(zhuǎn)換為TAP格式,,以便TestLink轉(zhuǎn)換為測試結(jié)果
這個配置是將TAP結(jié)果返回到Testlink,,
注意:
Include Pattern:這里的路徑與build.xml文件中輸出的路徑一致。
7.6. TAP結(jié)果發(fā)布
Test results:結(jié)果路徑配置,,與build.xml中配置輸出路徑一致
7.7. 構(gòu)建后郵件發(fā)送
增加構(gòu)建后操作:Editable Email Notification
7.8. 系統(tǒng)配置:郵件的全局參數(shù)配置
未截圖的按默認配置
備注:
Default Subject:用例執(zhí)行結(jié)果:$PROJECT_NAME - Build # $BUILD_NUMBER - $BUILD_STATUS!
Default Content:
${FILE,path="sum/sum.html"}<hr/>
(本郵件是程序自動下發(fā)的,,請勿回復!)<br/>
項目名稱:$PROJECT_NAME<br/>
構(gòu)建編號:$BUILD_NUMBER<br/>
svn版本號:${SVN_REVISION}<br/>
構(gòu)建狀態(tài):$BUILD_STATUS<br/>
觸發(fā)原因:${CAUSE}<br/>
構(gòu)建日志地址:<a href="${BUILD_URL}console">${BUILD_URL}console</a><br/><hr/>
構(gòu)建地址:<a href="$BUILD_URL">$BUILD_URL</a><br/><hr/>
變更集:${JELLY_SCRIPT,template="html"}<br/><hr/>
郵件通知配置,,根據(jù)郵箱實際情況進行配置即可,,如下:
8.附錄
JMX2TAP.SH內(nèi)容:
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.
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} "http://httpSample[contains(@lb,'${filename}')]/@rc" 2>/dev/null) )
29 TestCase_count2=( $(xpath ${XML_resultfile} "http://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} "http://httpSample[contains(@lb,'${filename}')]/assertionResult[failure='true']/failure" 2>/dev/null | tr -d '"' | tr ' ' '_' | sed 's/^_//') )
40 result_if2=( $(xpath ${XML_resultfile} "http://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} "http://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 done
View Code
build.xml內(nèi)容
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測試結(jié)果放置目錄,這里是放在構(gòu)建項目下的result目錄-->
9 <property name="jmeter.sum.dir" value="${env.WORKSPACE}/sum" /><!-- jmeter測試概要放置目錄(主要用于郵件發(fā)送時,,作正文內(nèi)容),這里是放在構(gòu)建項目下的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 <!-- 配置構(gòu)建參數(shù)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測試報告轉(zhuǎn)化為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構(gòu)建后郵件發(fā)送的正文展示 -->
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>
72
View Code
|