Ubuntu Jenkins如何邮件通知

Ubuntu Jenkins配置邮件通知步骤

一、安装邮件插件（推荐Email Extension Plugin）

Jenkins自带邮件功能有限，需安装专业插件扩展能力。

1. 进入Jenkins管理界面，点击Manage Jenkins -> Manage Plugins；
2. 在“Available”标签页搜索“Email Extension Plugin”，点击“Install without restart”安装；
3. 安装完成后重启Jenkins，使插件生效。

二、系统级邮件设置（全局配置）

配置SMTP服务器及发件人信息，作为项目邮件通知的基础。

1. 进入Manage Jenkins -> Configure System；
2. 找到“Extended E-mail Notification” section（若未找到，需先安装Email Extension Plugin）：
   • SMTP服务器：填写服务商提供的地址（如Gmail为smtp.gmail.com，企业邮箱如QQ为smtp.qq.com）；
   • 端口：根据SMTP协议选择（SSL加密通常为465或587，TLS为587）；
   • SSL/TLS：勾选对应加密方式（如Gmail需启用SSL）；
   • 用户名/密码：填写SMTP认证账号（如Gmail邮箱地址）及密码（若邮箱开启两步验证，需使用应用专用授权码代替密码，如QQ邮箱需在“设置-> 账户-> 生成授权码”中获取）；
3. 管理员邮箱：在“Jenkins Location” section设置“System Admin e-mail address”，需与SMTP认证的发件人邮箱一致（如admin@example.com）；
4. 测试配置：勾选“Test configuration by sending test e-mail”，输入接收测试邮件的邮箱地址，点击“Test configuration”验证连通性（若测试失败，需检查SMTP设置、防火墙是否放行对应端口）。

三、项目级邮件配置（触发条件与收件人设置）

针对具体项目配置邮件触发逻辑及收件人。

1. 进入需要配置的项目页面，点击Configure；
2. 在“Build Post Actions” section，点击“Add build post action”，选择“Editable Email Notification”；
3. 收件人设置：
   • “Project Recipient List”：填写项目默认收件人（多个邮箱用逗号分隔，如dev1@example.com,dev2@example.com）；
   • “Additional Recipients”：可选添加额外收件人（如项目经理邮箱）；
4. 邮件内容定制（可选）：
   • 点击“Advanced settings”，可修改邮件主题（如${ PROJECT_NAME} - Build #${ BUILD_NUMBER} - ${ BUILD_STATUS} ）、内容模板（支持HTML/Groovy脚本，如包含构建日志链接、变更集信息）；
   • 可从“JENKINS_HOME/email_templates”目录加载自定义模板（需提前创建）；
5. 触发条件设置（可选）：
   • 点击“Add Trigger”，选择邮件发送时机（如“Failure”构建失败时发送、“Success”构建成功时发送、“Unstable”不稳定时发送、“Fixed”从失败恢复时发送等）；
6. 测试项目配置：保存项目配置后，手动触发一次构建（如点击“Build Now”），观察是否收到邮件。

四、常见问题排查

1. 邮件无法发送：
   • 检查Jenkins服务器网络连接（能否访问SMTP服务器地址）；
   • 确认防火墙/安全组是否放行SMTP端口（如587、465）；
   • 验证SMTP认证信息是否正确（尤其是授权码是否过期）；
2. 邮件内容格式错乱：
   • 检查模板中的Groovy脚本语法（如变量引用需用${ VARIABLE} ）；
   • 若使用HTML模板，确保内容符合HTML规范；
3. 收件人未收到邮件：
   • 检查收件人邮箱是否反垃圾（可将Jenkins发件人地址加入白名单）；
   • 查看Jenkins系统日志（“Manage Jenkins” -> “System Log”），查找邮件发送失败的详细错误信息。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！