Jenkins在Linux上如何配置邮件通知

Jenkins在Linux上配置邮件通知的完整步骤

1. 安装必要插件

要使用Jenkins的邮件通知功能，需先安装Email Extension Plugin（支持丰富的邮件模板和触发器）及SMTP Plugin（提供SMTP协议支持）。
操作路径：登录Jenkins管理界面 → 点击顶部菜单栏「Manage Jenkins」→ 选择「Manage Plugins」→ 切换至「Available」标签页 → 搜索“Email Extension Plugin”并勾选安装（若未自动安装SMTP插件，可同时搜索“SMTP Plugin”并安装）→ 安装完成后重启Jenkins使插件生效。

2. 配置全局SMTP邮件服务器

全局配置是Jenkins发送邮件的基础，需设置SMTP服务器信息及认证参数。
操作路径：登录Jenkins → 「Manage Jenkins」→ 「Configure System」→ 向下滚动至「Extended E-mail Notification」部分（若未找到，需先勾选「Enable extended E-mail notification」启用扩展功能）→ 填写以下信息：

SMTP Server：输入SMTP服务器地址（如Gmail为smtp.gmail.com，企业邮箱为对应的SMTP服务器，如smtp.exmail.qq.com）；
SMTP Port：输入SMTP端口（常用587（TLS加密）、465（SSL加密）或25（非加密，部分服务器可能禁用））；
SMTP User Name：输入SMTP账户用户名（如个人邮箱your_email@gmail.com，企业邮箱your_name@company.com）；
SMTP Password：输入SMTP账户密码（若使用Gmail等第三方邮箱，可能需要生成「应用专用密码」替代原密码）；
Use SMTP Authentication：勾选（启用SMTP认证）；
Start TLS if available：勾选（启用TLS加密，推荐）；
Default Subject Prefix：输入邮件主题前缀（如[Jenkins]，便于区分邮件来源）；
From Address：输入发件人地址（建议与SMTP账户一致，如jenkins@yourdomain.com）。
填写完成后，点击「Test Configuration」按钮，输入一个有效邮箱地址（如自己的私人邮箱），点击「Test」发送测试邮件。若收到测试邮件，说明SMTP配置成功。

3. 配置项目特定邮件通知

全局配置完成后，需在具体Jenkins项目中设置邮件触发的条件和收件人。
操作路径：进入目标项目页面 → 点击「Configure」→ 向下滚动至「Post-build Actions」部分 → 点击「Add post-build action」→ 选择「Editable Email Notification」→ 配置以下内容：

Recipient List：输入邮件接收者地址（多个地址用逗号分隔，如user1@example.com,user2@example.com）；
Subject：输入邮件主题（可使用Groovy脚本动态生成，如Build Status: ${BUILD_STATUS} - Job: ${JOB_NAME}）；

Body：输入邮件正文（支持HTML格式，可使用Groovy脚本嵌入动态信息，如：

<html>
  <body>
    <h2>Build Notification</h2>
    <p><strong>Project:</strong> ${PROJECT_NAME}</p>
    <p><strong>Build Number:</strong> ${BUILD_NUMBER}</p>
    <p><strong>Build Status:</strong> ${BUILD_STATUS}</p>
    <p><strong>Build URL:</strong> <a href="${BUILD_URL}">${BUILD_URL}</a></p>
    <p><strong>Console Output:</strong> <a href="${BUILD_URL}console">View Console</a></p>
  </body>
</html>
```）；

Triggers：点击「Add Trigger」选择触发邮件的条件（常见选项：
- Failure：构建失败时发送；
- Success：构建成功时发送；
- Unstable：构建不稳定时发送（如测试未通过）；
- Fixed：上次失败后本次成功时发送；
- Still Failing：上次失败后本次仍失败时发送）。
  配置完成后，点击页面底部「Save」保存项目配置。

4. 测试邮件通知

配置完成后，可通过手动触发构建或等待自动触发（如代码提交）来验证邮件通知是否生效。
操作路径：进入项目页面 → 点击「Build Now」手动触发构建 → 等待构建完成 → 检查收件箱（包括垃圾邮件箱）是否收到邮件。若未收到邮件，需检查以下内容：

SMTP服务器配置是否正确（如端口、加密方式、用户名密码）；
邮件服务器是否允许Jenkins服务器IP发送邮件（部分邮箱需开启「允许不够安全的应用」或添加IP白名单）；
Jenkins日志是否有错误信息（可通过「Manage Jenkins」→ 「System Log」查看）。

通过以上步骤，即可在Linux系统上成功配置Jenkins的邮件通知功能，实现构建状态的实时邮件提醒。

Jenkins在Linux上配置邮件通知的完整步骤

1. 安装必要插件

2. 配置全局SMTP邮件服务器

3. 配置项目特定邮件通知

4. 测试邮件通知

最新问答

相关标签