手把手教你如何在window下將jenkins+allure集成生成的測試報告通過jenkins配置郵箱自動發送-04(非常詳細,非常實用)
- 2019 年 10 月 11 日
- 筆記
簡介
上一篇生成測試報告,小夥伴們和童鞋們就又問道,測試報告已經生成了,怎麼發送給相關的負責人了?小夥伴們和童鞋們不要著急,聽宏哥慢慢給你道來,心急吃不了熱豆腐哈。今天這篇文章宏哥就給小夥伴和童鞋們來答疑解惑了,當然了方式方法多種多樣的,你可以通過郵件、QQ、微信將測試報告附件手動寫郵件發送給相關負責人。這裡宏哥講解如何將測試報告自動發送給相關的負責人。
安裝插件
1、安裝插件:Email Extension Plugin
從上一篇文章想必大家都知道了如何安裝插件的兩種方法了吧。在這裡宏哥還是選擇第二種方法,建議小夥伴和童鞋們也選擇這種方法。這樣就不需要找那個插件文件的下載地址,版本與jenkins的兼容等等一系列奇奇怪怪的問題了。不要自己給自己挖坑,自己坑自己。當然了,有受虐傾向的除外了。呵呵和大家開玩笑,自己開心就好,想怎麼樣都可以。
步驟:系統管理-插件管理-安裝Email Extension插件
從上圖可以看出,這裡宏哥已經安裝好了2.66的,如果需要更新的可以更新到最新的2.68。由於時間關係,宏哥這裡就不做更新操作了。
配置發送郵件資訊
1)系統管理-系統設置-Jenkins Location,這裡的管理員地址要和發送人的郵箱地址一樣,要不然會有問題。
2)系統管理-系統設置-Extended E-mail Notification-高級,根據紅框內容填寫。
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:[email protected]
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:郵件中可以使用的變數,所有的變數都是可選的。
郵件模板引用別的模板,然後自己改編的:
default subject [構建通知]:${BUILD_STATUS} – ${PROJECT_NAME} – Build # ${BUILD_NUMBER} !
1)模板1
<!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>
3)配置後發送測試郵件看是否成功發送。宏哥這裡發送測試郵件成功如下:
到郵箱查看如下圖:
配置構建後操作
jenkins-項目(需要發送郵件的任務)-配置-構建後操作-Editable Email Notification
點擊“Advanced Settings”
點擊“Add Trigger”,設置郵件的觸發條件:
當插件激活後你就能編輯如下欄位(只列出常用的欄位):
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:當構建開始時發送郵件。
構建生成報告,並發送郵件
1)點擊“立即構建”生成測試報告,然後發送郵件到相關的負責人郵箱
小結
1)那個郵件的主題和模板內容可以單獨給項目配置,也可以統一在插件處配置。單獨項目配置的會覆蓋插件出的配置,如果單獨項目沒有配置,會默認使用插件的配置。
2)可能存在發送報錯501
501解決方法:
3)可能存在發送報錯535
535解決方法:
檢查授權碼是否正確
4)QQ郵箱注意事項
QQ郵箱開啟IMAP/SMTP服務:設置–賬戶
QQ郵箱伺服器埠號
5)如果測試郵件發送成功,立即構建後,郵件卻發送失敗,將這個勾選上,在構建時查看控制台的日誌,進行錯誤排查
您的肯定就是我進步的動力。如果你感覺還不錯,就請鼓勵一下吧!記得點波 推薦 哦!!!(點擊右邊的小球即可!(^__^) 嘻嘻……)