配置郵件系統之前,確保你已經安裝了該插件,安裝方法可以找之前文章瞭解。首先需要進行全局設置,點擊左側菜單“系統管理”—“系統設置”,如下圖:
在系統設置中找到“Extended E-mail Notification”項,在該項中可以配置一些全局的email-ext屬性,下圖是我的配置:
下面是我的配置:
Default Subject:構建通知:${BUILD_STATUS} - ${PROJECT_NAME} - Build # ${BUILD_NUMBER} !
Default Content:
<!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">構建結果 - ${BUILD_STATUS}</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>SVN 版本: ${SVN_REVISION}</li>
<li>觸發原因: ${CAUSE}</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>
<tr>
<td><b><font color="#0B610B">Changes Since Last
Successful Build:</font></b>
<hr size="2" width="100%" align="center" /></td>
</tr>
<tr>
<td>
<ul>
<li>歷史變更記錄 : <a href="${PROJECT_URL}changes">${PROJECT_URL}changes</a></li>
</ul> ${CHANGES_SINCE_LAST_SUCCESS,reverse=true, format="Changes for Build #%n:<br />%c<br />",showPaths=true,changesFormat="<pre>[%a]<br />%m</pre>",pathFormat=" %p"}
</td>
</tr>
<tr>
<td><b>Failed Test Results</b>
<hr size="2" width="100%" align="center" /></td>
</tr>
<tr>
<td><pre
style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">$FAILED_TESTS</pre>
<br /></td>
</tr>
<tr>
<td><b><font color="#0B610B">構建日誌 (最後 100行):</font></b>
<hr size="2" width="100%" align="center" /></td>
</tr>
<!-- <tr>
<td>Test Logs (if test has ran): <a
href="${PROJECT_URL}ws/TestResult/archive_logs/Log-Build-${BUILD_NUMBER}.zip">${PROJECT_URL}/ws/TestResult/archive_logs/Log-Build-${BUILD_NUMBER}.zip</a>
<br />
<br />
</td>
</tr> -->
<tr>
<td><textarea cols="80" rows="30" readonly="readonly"
style="font-family: Courier New">${BUILD_LOG, maxLines=100}</textarea>
</td>
</tr>
</table>
</body>
</html>
全局屬性介紹:
1. .Override Global Settings:如果不選,該插件將使用默認的 E-mail Notification 通知選項。反之,您可以通過指 定不同於( 默認選項)的設置來進行覆蓋。
2. Default Content Type:指定構建後發送郵件內容的類型,有 Text 和 HTML 兩種.
3. Use List-ID Email Header:爲所有的郵件設置一個 List-ID 的郵件信頭,這樣你就可以在郵件客戶端使用過濾。
它也能阻止郵件發件人大部分的自動回覆 (諸如離開辦公室、休假等等 )。你可以使用你習慣的任何名稱或者 ID 號, 但是他們必須符合如下其中一種格式 (真實的 ID 必須要包含在<和>標記裏):
Build Notifications <ci-notifications.company.org>
“Build Notifications” <ci-notifications.company.org>
關於更詳細的 List-ID 說明請參閱 RFC-2919.
4. Add 'Precedence: bulk' Email Header:設置優先級,更詳細說明請參閱 RFC-3834.
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:郵件中可以使用的變量,所有的變量都是可選的。
上面是全局設置,要想激活郵箱通知,還需要在任務配置中配置,進入到任務配置中選擇“增加構建後操作步驟”,選擇Editable Email Notification,如圖:
添加郵件通知後,默認是不會發送郵件通知的,因爲我們還沒有配置郵件觸發器,選擇Advanced Settings,將會添加一個成功的觸發器如圖:
觸發器的郵件屬性和之前全局的配置是一樣的,這裏可以爲不同的觸發條件配置不同的郵件內容。可以點擊下面的Add Trigger添加多個觸發器,這樣就可以做到成功、失敗通知到不同的人員,可以有以下觸發器,所有的觸發器都只能配置一次:
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:當構建開始時發送郵件。