Jenkins 系列 -- 邮件通知

概述

打包成功，我们需要通知相关人员下载最新的安装包进行测试。或者打包失败需要通知开发人员看看什么原因等等，所以打包后发个邮件通知下相关人员，相当的有必要。

设置邮箱

jenkins 自带的邮件通知不是很好用。我们使用插件版本Email-extension plugin，这个插件在推荐插件列表中。如果你当时选择了安装推荐插件，那么你已经安装好了。如果没有可以自行搜索安装。所以这里我们直接去设置。
Manage Jenkins --> Configure System -->Extended E-mail Notification

是的有一堆东西要填写

SMTP server 获取

各个邮箱的设置略有不同，但基本大同小异。我这里只演示使用163邮箱如何设置
可以搜索关键字 163邮箱smtp设置端口 ，就可以找到
企业邮箱的POP、SMTP、IMAP服务器地址设置帮助文档或163 帮助中心。获取详细的 SMTP配置相关信息。另外也可以在设置页面找到 SMTP 服务器地址，但无法查到端口，如下所示。

设置SMTP相关信息到对应的输入框即可，如下。

Use SMTP Authentication 设置

勾选Use SMTP Authentication ，需要填写用户名和密码。用户名也就邮箱的登录账号。KaTeX parse error: Undefined control sequence: \bbox at position 1: \̲b̲b̲o̲x̲[yellow,4px,bor…，否则无法通过验证。但是密码却不是登录密码，而是客户端授权密码。客户端授权密码可以通过设置-->客户端授权密码 获取 。如下所示

**提醒：**我这里因为设置过了，所以显示为重置。若没有设置过，会有弹出框让你输入授权密码。

邮件内容设置

邮件内容设置如下。

其实有挺多的默认项可以设置，比如。

• Default Context Type 最好为HTML.也可以默认，后续项目中也可以设置。
• Default Recipients 默认收件人，多个用英文逗号隔开。
• Default Subject设置为[Jenkins构建通知]$PROJECT_NAME - Build # $BUILD_NUMBER - $BUILD_STATUS! 我把项目名称、编号、状态设置到标题中了。
• 邮件内容

(邮件由Jenkins自动发出，请勿回复~)<br>
项目名称：$PROJECT_NAME<br>
构建编号：$BUILD_NUMBER<br>
构建状态：$BUILD_STATUS<br>
触发原因：${CAUSE}<br>
构建地址：<A HREF="${BUILD_URL}">${BUILD_URL}</A><br>
构建输出日志：<a href="http://localhost:8080/job/${PROJECT_NAME}/${BUILD_NUMBER}/console">http://localhost:8080/job/${PROJECT_NAME}/${BUILD_NUMBER}/console</a><br>
下载地址：<a href='http://124.54.273.741:8080/apk/${BUILD_TIME}/JenkinsTest-v${APP_VERSION_NAME}-${PRODUCT_FLAVORS}-${BUILD_TYPE}.apk '>点击下载 JenkinsTest-v${APP_VERSION_NAME}-${PRODUCT_FLAVORS}-${BUILD_TYPE}.apk-</a> <br> 
二维码下载：<img src='http://231.34.220.124:8080/apk/${BUILD_TIME}/jenkins.png' width=200px height=200px> <br> 
最近修改：<br>${CHANGES, showPaths=false, format="%a：\"%m\"<br>", pathFormat="\n\t- %p"}

邮件内容，我把apk 的下载地址，二维码的地址等都拼接到邮件中了。这样收件人后续要下载apk 就很方便。

项目中的邮件设置

增加构建后步骤 Editable Email Notification

一般属性设置

点击增加构建后步骤，在弹出菜单中选择 Editable Email Notification。不要选择E-mail Notification,这个是jenkins 系统自带的邮件。我们使用的是插件版本Email-extension plugin，功能更强大。

• Project Recipient List 收件人列表：可以引用之前设置的 DEFAULT_RECIPIENTS，多个收件人用英文逗号隔开，如 $DEFAULT_RECIPIENTS,ifjgm003@163.com
• Project Reply-To List，默认回件人$DEFAULT_REPLYTO。
• Content Type内容类型，因为之前设置邮件的时候就设置过，所以这里可以为默认。最好Html 和 Plain text
• Default Subject默认标题，我们引用之前设置的默认标题就好，$DEFAULT_SUBJECT。
• Default Content默认内容，同样引用之前设置的默认内容，$DEFAULT_CONTENT
• Attach Build Log： 下拉项。可以选择Attach Build Log，将构建日志作为附件放入邮件中。

构建触发器设置

就是什么时候发送邮件，构建失败？构建成功？还是不管什么情况下都发送。
这个在 Editable Email Notification 的高级设置里进行设置。

• 可以点击 Add Trigger添加不同类型的触发器。我们可以添加一个Always类型的触发器。
• Send to设置将邮件发送给哪些组。比如开发组developers或Recipient list,也可以通过点击新增按钮，添加其他组作为收件人。

效果

现在我们构建项目后，就会发送邮件给刚刚设置的收件人。效果如下

总结

这是jenkins 系列的最后一篇了。jenkins 真的很强大，功能很丰富。可以通过插件扩展出不同的功能。到这里我们也够我们日常开发使用了，如果需要再深入研究，就看你的具体需求了。