一.安裝allure
1)下載 allure.zip 下載地址:allure-github: https://github.com/allure-framework/allure2
2)解壓到本地目錄、配置allure.bat的環境變量Path; 在命令行中運行allure,確認環境變量配置成功
2.pytest插件安裝 命令:pip install allure-pytest
二.jenkins集成+生成Allure報告
1.jenkins安裝插件Allure
2.配置Allure環境
3.配置生成報告的路徑
4.是否指定工作空間
1)如果你不是放在git或者svn上面的代碼,那么你可以直接指定工作空間
2)如果是放在git或者svn上面的代碼,那么你就不需要指定工作空間
5.執行window批處理命令
6.立即構造(構造后就可以查看allure report報告啦)
7.可能出現錯誤解決方法
問題一:
原因:jenkins執行windows命令,若退出代碼不為0 ,則jenkins會將構建標記為失敗,所以需要加上exit 0表示執行完成退出
解決方法:構建命令在pytest前面加上call,最后加上exit 0
問題二:
原因:提示 exit -XXXX 啥的 那是缺少本機的Windows組件
解決方法:自己百度exit -XXXX 下載對應的組件安裝
問題三:
原因:就是在配置Allure Commandline安裝時候配置的安裝目錄地址寫到bin
解決方法:地址中去掉bin
三.生成報告然后發送郵箱
1.安裝插件
系統管理-插件管理-安裝Email Extension插件
2.配置發送郵件信息
1)系統管理-系統設置-Jenkins Location,這里的管理員地址要和發送人的郵箱地址一樣,要不然會有問題。
系統管理-系統設置-Extended E-mail Notification,根據紅框內容填寫。
1. Override Global Settings:如果不選,該插件將使用默認的E-mail Notification通知選項。反之,您可以通過指定不同於( 默認選項)的設置來進行覆蓋。
2. Default Content Type:指定構建后發送郵件內容的類型,有Text和HTML兩種.
3. Use List-ID Email Header:為所有的郵件設置一個List-ID的郵件信頭,這樣你就可以在郵件客戶端使用過濾。它也能阻止郵件發件人大部分的自動回復(諸如離開辦公室、休假等等)。你可以使用你習慣的任何名稱或者ID號,但是他們必須符合如下其中一種格式(真實的ID必須要包含在<和>標記里):
<ci-notifications.company.org>
Build Notifications <ci-notifications.company.org>
“Build Notifications” <ci-notifications.company.org>
4. Add 'Precedence: bulk' Email Header:設置優先級,
5. Default Recipients:自定義默認電子郵件收件人列表。如果沒有被項目配置覆蓋,該插件會使用這個列表。您可以在項目配置使用$ DEFAULT_RECIPIENTS參數包括此默認列表,以及添加新的地址在項目級別。添加抄送:cc:電子郵件地址例如,CC:someone@somewhere.com
6. Reply To List:回復列表, A comma separated list of e-mail addresses to use in the Reply-To header of the email. This value will be available as $DEFAULT_REPLYTO in the project configuration.
7. Emergency reroute:如果這個字段不為空,所有的電子郵件將被單獨發送到該地址(或地址列表)。
8. Excluded Committers:防止郵件被郵件系統認為是垃圾郵件,郵件列表應該沒有擴展的賬戶名(如:@domain.com),並且使用逗號分隔
9. Default Subject:自定義郵件通知的默認主題名稱。該選項能在郵件的主題字段中替換一些參數,這樣你就可以在構建中包含指定的輸出信息。
10. Maximum Attachment Size:郵件最大附件大小。
11. Default Content:自定義郵件通知的默認內容主體。該選項能在郵件的內容中替換一些參數,這樣你就可以在構建中包含指定的輸出信息。
12. Default Pre-send Script:默認發送前執行的腳本(注:grooy腳本,這是我在某篇文章上看到的,不一定准確)。
13. Enable Debug Mode:啟用插件的調試模式。這將增加額外的日志輸出,構建日志以及Jenkins的日志。在調試時是有用的,但不能用於生產。
14. Enable Security:啟用時,會禁用發送腳本的能力,直接進入Jenkins實例。如果用戶試圖訪問Jenkins管理對象實例,將拋出一個安全異常。
15. Content Token Reference:郵件中可以使用的變量,所有的變量都是可選的。
2)可能存在發送報錯501
501解決方法:
3)可能存在發送報錯535
535解決方法:
檢查授權碼是否正確
郵件模板引用別的模板,然后自己改編的:
default subject [構建通知]:${BUILD_STATUS} - ${PROJECT_NAME} - Build # ${BUILD_NUMBER} !
1)模板1(allure專用)
<!DOCTYPE html> <html lang="en"> <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> 本郵件由系統自動發出,無需回復!<br/> 各位同事,大家好,以下為${PROJECT_NAME }項目構建信息</br> <h1><center><font color="red">allure報告在線查看or下載allure-report.zip用firefox離線查看,測試用例見附件</font><center></h1> </tr> <tr> <td><br/> <b><font color="#0B610B">項目描述:${JOB_DESCRIPTION}<br></font></b> <hr size="2" width="100%" align="center" /></td> </tr> <tr> <td> <ul> <li>項目名稱 : ${PROJECT_NAME}</li> <li>構建編號 : 第${BUILD_NUMBER}次構建</li> <li>SVN 版本: ${SVN_REVISION}</li> <li>觸發原因: ${CAUSE}</li> <li>構建狀態: ${BUILD_STATUS}</li> <li>構建日志: <a href="${BUILD_URL}console">${BUILD_URL}console</a></li> <li>構建 Url : <a href="${BUILD_URL}">${BUILD_URL}</a></li> <li>工作目錄 : <a href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li> <li>項目 Url : <a href="${PROJECT_URL}">${PROJECT_URL}</a></li> <li>系統allure測試報告:<a HREF="${PROJECT_URL}${BUILD_NUMBER}/allure">${PROJECT_URL}${BUILD_NUMBER}/allure</a><li> </ul> </td> <tr> <td> <b><font color="#0B610B">構建日志 (最后 100行):</font></b> <hr size="2" width="100%" align="center" /> </td> </tr> <tr> <td> <textarea cols="80" rows="30" readonly="readonly" style="font-family: Courier New">${BUILD_LOG, maxLines=100}</textarea> </td> </tr> ${JELLY_SCRIPT} </table> </body> </html>
模板2:(非allure用)
<!DOCTYPE html> <html lang="en"> <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> 本郵件由系統自動發出,無需回復!<br/> 各位同事,大家好,以下為${PROJECT_NAME }項目構建信息</br> </tr> <tr> <td><br/> <b><font color="#0B610B">項目描述:${JOB_DESCRIPTION}<br></font></b> <hr size="2" width="100%" align="center" /></td> </tr> <tr> <td> <ul> <li>項目名稱 : ${PROJECT_NAME}</li> <li>構建編號 : 第${BUILD_NUMBER}次構建</li> <li>SVN 版本: ${SVN_REVISION}</li> <li>觸發原因: ${CAUSE}</li> <li>構建狀態: ${BUILD_STATUS}</li> <li>構建日志: <a href="${BUILD_URL}console">${BUILD_URL}console</a></li> <li>構建 Url : <a href="${BUILD_URL}">${BUILD_URL}</a></li> <li>工作目錄 : <a href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li> <li>項目 Url : <a href="${PROJECT_URL}">${PROJECT_URL}</a></li> </ul> </td> <tr> <td> <b><font color="#0B610B">構建日志 (最后 100行):</font></b> <hr size="2" width="100%" align="center" /> </td> </tr> <tr> <td> <textarea cols="80" rows="30" readonly="readonly" style="font-family: Courier New">${BUILD_LOG, maxLines=100}</textarea> </td> </tr> ${JELLY_SCRIPT} </table> </body> </html>
3.配置構建后操作
jenkins-項目-配置-構建后操作-Editable Email Notification
當插件激活后你就能編輯如下字段(只列出常用的字段):
Project Recipient List:這是一個以逗號(或者空格)分隔的收件人郵件的郵箱地址列表。允許您為每封郵件指定單獨的列表。Ps:如果你想在默認收件人的基礎上添加收件人:$DEFAULT_RECIPIENTS,<新的收件人>
Default Subject:允許你配置此項目郵件的主題。
Default Content:跟Default Subject的作用一樣,但是是替換郵件內容。
Attach Build Log:附件構建日志。
Compress Build Log before sending:發送前壓縮生成日志(zip格式)。
Triggers條件:
Failure:即時發送構建失敗的郵件。如果”Still Failing”觸發器已配置,而上一次構建的狀態是”Failure”,那么”Still Failing”觸發器將發送一封郵件來替代(它)。
Unstable:即時發送構建不穩固的郵件。如果”Still Unstable”觸發器已配置,而上一次構建的狀態是”Unstable”,那么”Still Unstable”觸發器將發送一封郵件來替代(它)。
Still Failing:如果兩次或兩次以上連續構建的狀態為”Failure”,發送該郵件。
Success:如果構建的狀態為”Successful”發送郵件。如果”Fixed”已配置,而上次構建的狀態為“Failure”或“Unstable”,那么”Fixed”觸發器將發送一封郵件來替代(它)。
Fixed:當構建狀態從“Failure”或“Unstable”變為”Successful”時發送郵件。
Still Unstable:如果兩次或兩次以上連續構建的狀態為” Unstable “,發送該郵件。Before Build:當構建開始時發送郵件。
4.構建生成報告