Jenkins : 邮件通知

插件一样， 插件的全局配置也是在 Jenkins -> Manage Jenkins -> Configure System 中。具体的配置项非常多，下面介绍几个比较基本且重要的配置项。

名称或 IP 地址。

邮件类型邮件或者是纯文本格式的邮件：

默认标题默认的标题为：

$PROJECT_NAME - Build # $BUILD_NUMBER - $BUILD_STATUS!

显示项目名称，Build 号和 Build 结果。如果没有其它的要求，这个标题也算是简单明了啊！

默认的邮件内容默认的邮件内容为：

$PROJECT_NAME - Build # $BUILD_NUMBER - $BUILD_STATUS:

Check console output at $BUILD_URL to view the results.

邮件模板等功能实现一个完整的邮件内容，所以可以忽略这个默认的内容。

默认的触发条件通知方式，在什么条件下触发邮件通知是极为重要的。Email Extension 插件支持的触发器类型是很丰富的：

默认设置没那么重要，因为每个项目的情况都是不一样的，所以最终都需要在项目上进行设置。而项目上的设置会覆盖这里的默认设置。

添加邮件通知

邮件的内容可以包含大量的信息，如果每个项目中都自己组织这些信息会费时费力。使用邮件的模板功能可以极大的提高生产力！插件支持两种类型的邮件模板，分别是 Jelly 模板和 Groovy 模板。当前的现状是 Groovy 模板正在逐步的取代 Jelly 模板。但是两种模板的设置和使用方式基本一样，我们以 Groovy 模板为例进行介绍。插件的官方文档中可以找到模板的下载地址。笔者以下载的 groovy-html.template 文件为例进行说明。首先是安装邮件模板，其实就是把模板文件复制到 Jenkins 安装目录下的 email-templates 目录中，如果该目录不存在就先创建它。一个添加了 "Editable Email Notification" 的项目，你会发现在左边的菜单中多了一项 "Email Template Testing"：

菜单项并且输入刚才安装的模板名称：

一个预览的邮件内容就会出现在下面的空白处。邮件通知的配置中应用这个模板。其实就是设置 Default Content 为：邮件的模板设置已经完成，赶快触发个 Build 看看结果吧！

支持

stage('test''hello' "SUCCESSFUL: Job '${env.JOB_NAME} [${env.BUILD_NUMBER}]'""[email protected]""""

SUCCESSFUL: Job '${env.JOB_NAME} [${env.BUILD_NUMBER}]':

Check console output at "${env.JOB_NAME} [${env.BUILD_NUMBER}]"

""",recipientProviders: [[$: 'DevelopersRecipientProvider'"Failed: Job '${env.JOB_NAME} [${env.BUILD_NUMBER}]'""""

Failed: Job '${env.JOB_NAME} [${env.BUILD_NUMBER}]':

Check console output at "${env.JOB_NAME} [${env.BUILD_NUMBER}]"

""",recipientProviders: [[$: 'DevelopersRecipientProvider'

代码在 stage 执行成功或者失败的情况下发送邮件。但邮件的内容只是简单的纯文本或这是 HTML 格式的文本。笔者尝试在 pipeline 代码中使用邮件模板的功能，但不管是 Jelly 模板还是 Groovy 模板都不能正常工作，所以这里还有待完善的功能。

功能全面的 Jenkins 邮件通知插件。随着 pipeline 日渐成为主流的持续集成方式，希望能 Email Extension 也能紧跟趋势提供对 pipeline 更好的支持。