霍格沃兹测试学院 TestingStudio
一、插件下载
在配置 Email 之前我们需要下载两个插件：
Email Extension,Email Extension Template，这两个插件可以帮助我们进行邮件的编写发送以及格式化
- 在
系统管理->插件管理中下载插件：
二、配置 Email (Jenkins 自带)
2.1 基础信息查询
找到所要配置邮箱的基础信息，这里以 QQ 邮箱为例
-
通过网页端 QQ 邮箱的设置进入到邮箱客户端设置页面。
-
找到邮箱的基础信息。
2.2 Jenkins邮件通知配置
-
在 Jenkins：
系统管理->系统配置中，最底部找到邮件通知，打开高级： -
填入配置信息后如下：
-
注意到在配置的下方有个"通过发送测试邮件测试配置"，我们可以讲其勾选，填入邮箱地址，点击
Test configuration来先测试一下邮件的发送.
2.3 踩坑时刻
- 如果按照上面的方式，点击
Test configuration会出现以下报错：
javax.mail.AuthenticationFailedException: 535 Login Fail. Please enter your authorization code to login. More information in http://service.mail.qq.com/cgi-bin/help?subtype=1&&id=28&&no=1001256
这是因为使用 QQ 邮箱登录，需要填入的是 QQ 邮箱的授权码，这是用于登录第三方客户端的专用密码。具体的获取方式可参考：
https://service.mail.qq.com/cgi-bin/help?subtype=1&&no=1001256&&id=28
- 修改完授权码后，再次测试,很可能又会收到如下报错:
java.net.SocketException: Connection closed by remote host
这是因为我们还需要在设置Jenkins Location中配置系统管理员邮件地址，此地址要和邮件通知中的用户名一致。
霍格沃兹测试学院 TestingStudio
2.4 结果验收
做完了上述步骤后再次测试可以看到邮件发送成功。
三、配置 Email(Extended E-mail Notification)
记得文章一开头提到的下载 Extended 插件，没错，Jenkins 系统设置里还可以通过
Extended E-mail Notification对邮件发送进行模板格式的自定义。
3.1 基础信息配置
基础信息配置与上述一致，唯一要注意的是这里需要重新生成一个授权码。
3.2 模板格式配置
这里主要就是配置展示的模板格式，常用的格式化的参数有：
- $BUILD_STATUS – 构建结果
- $PROJECT_NAME – 构建脚本名称
- $BUILD_NUMBER – 构建脚本编号
- $JOB_DESCRIPTION – 构建项目描述
- $CAUSE – 脚本启动原因
- $BUILD_URL – 脚本构建详情URL地址
这里选择以 HTML 的格式展示，填入模板：
<hr/>(自动化构建邮件，无需回复！)<br/><hr/>
项目名称：$PROJECT_NAME<br/><br/>
项目描述：$JOB_DESCRIPTION<br/><br/>
运行编号：$BUILD_NUMBER<br/><br/>
运行结果：$BUILD_STATUS<br/><br/>
触发原因：${CAUSE}<br/><br/>
构建日志地址：<a href="${BUILD_URL}console">${BUILD_URL}console</a><br/><br/>
构建地址：<a href="$BUILD_URL">$BUILD_URL</a><br/><br/>
详情：${JELLY_SCRIPT,template="html"}<br/>
<hr/>
3.3 触发条件配置
我们还可以在Default Triggers中根据自己的需要配置邮件的触发条件：
这里为了防止因为构建一直尝试结果均为失败而造成的邮件轰炸，可以设置邮件仅第一次或第二次构建结果为失败时才发送邮件，后续失败的邮件将不再发送。
霍格沃兹测试学院 TestingStudio
3.4 结果验收
-
在构建的任务配置中，选择"
Editable Email Notification" -
配置邮件发送至
Recipient List中配置的邮件地址 -
保存后构建项目，查看结果，邮件发送成功
以上，欢迎大家一起交流探讨。
本文为霍格沃兹测试学院优秀学员 Jekins 学习踩坑笔记。测试开发技能进阶，文末加群。
一、插件下载
在配置 Email 之前我们需要下载两个插件：
Email Extension,Email Extension Template，这两个插件可以帮助我们进行邮件的编写发送以及格式化
- 在
系统管理->插件管理中下载插件：
二、配置 Email (Jenkins 自带)
2.1 基础信息查询
找到所要配置邮箱的基础信息，这里以 QQ 邮箱为例
-
通过网页端 QQ 邮箱的设置进入到邮箱客户端设置页面。
-
找到邮箱的基础信息。
2.2 Jenkins邮件通知配置
-
在 Jenkins：
系统管理->系统配置中，最底部找到邮件通知，打开高级： -
填入配置信息后如下：
-
注意到在配置的下方有个"通过发送测试邮件测试配置"，我们可以讲其勾选，填入邮箱地址，点击
Test configuration来先测试一下邮件的发送.
2.3 踩坑时刻
- 如果按照上面的方式，点击
Test configuration会出现以下报错：
javax.mail.AuthenticationFailedException: 535 Login Fail. Please enter your authorization code to login. More information in http://service.mail.qq.com/cgi-bin/help?subtype=1&&id=28&&no=1001256
这是因为使用 QQ 邮箱登录，需要填入的是 QQ 邮箱的授权码，这是用于登录第三方客户端的专用密码。具体的获取方式可参考：
https://service.mail.qq.com/cgi-bin/help?subtype=1&&no=1001256&&id=28
霍格沃兹测试学院 TestingStudio
- 修改完授权码后，再次测试,很可能又会收到如下报错:
java.net.SocketException: Connection closed by remote host
这是因为我们还需要在设置Jenkins Location中配置系统管理员邮件地址，此地址要和邮件通知中的用户名一致。
2.4 结果验收
做完了上述步骤后再次测试可以看到邮件发送成功。
三、配置 Email(Extended E-mail Notification)
记得文章一开头提到的下载 Extended 插件，没错，Jenkins 系统设置里还可以通过
Extended E-mail Notification对邮件发送进行模板格式的自定义。
3.1 基础信息配置
基础信息配置与上述一致，唯一要注意的是这里需要重新生成一个授权码。
3.2 模板格式配置
这里主要就是配置展示的模板格式，常用的格式化的参数有：
- $BUILD_STATUS – 构建结果
- $PROJECT_NAME – 构建脚本名称
- $BUILD_NUMBER – 构建脚本编号
- $JOB_DESCRIPTION – 构建项目描述
- $CAUSE – 脚本启动原因
- $BUILD_URL – 脚本构建详情URL地址
霍格沃兹测试学院 TestingStudio
这里选择以 HTML 的格式展示，填入模板：
<hr/>(自动化构建邮件，无需回复！)<br/><hr/>
项目名称：$PROJECT_NAME<br/><br/>
项目描述：$JOB_DESCRIPTION<br/><br/>
运行编号：$BUILD_NUMBER<br/><br/>
运行结果：$BUILD_STATUS<br/><br/>
触发原因：${CAUSE}<br/><br/>
构建日志地址：<a href="${BUILD_URL}console">${BUILD_URL}console</a><br/><br/>
构建地址：<a href="$BUILD_URL">$BUILD_URL</a><br/><br/>
详情：${JELLY_SCRIPT,template="html"}<br/>
<hr/>
3.3 触发条件配置
我们还可以在Default Triggers中根据自己的需要配置邮件的触发条件：
这里为了防止因为构建一直尝试结果均为失败而造成的邮件轰炸，可以设置邮件仅第一次或第二次构建结果为失败时才发送邮件，后续失败的邮件将不再发送。
3.4 结果验收
-
在构建的任务配置中，选择"
Editable Email Notification" -
配置邮件发送至
Recipient List中配置的邮件地址 -
保存后构建项目，查看结果，邮件发送成功
以上，欢迎大家一起交流探讨。
霍格沃兹测试学院 TestingStudio
