如何配置CentOS Jenkins的邮件通知

一、安装必要插件

在Jenkins管理界面，点击Manage Jenkins > Manage Plugins，进入“Available”标签页，搜索并安装以下插件：

• Email Extension Plugin（必选，支持定制邮件内容、触发条件和接收者）；
• SMTP Plugin（可选，若Email Extension Plugin未自动安装SMTP插件则需单独安装）。

二、配置全局SMTP邮件设置

1. 进入Manage Jenkins > Configure System，向下滚动至Extended E-mail Notification部分；
2. 勾选Enable extended E-mail notification（启用扩展邮件通知）；
3. 填写SMTP服务器信息：
   • SMTP Server：输入SMTP服务器地址（如Gmail为smtp.gmail.com，企业邮箱需替换为对应地址）；
   • SMTP Port：输入端口（如Gmail的TLS端口为587，SSL端口为465）；
   • SMTP User Name：输入SMTP用户名（通常为邮箱地址，如your_email@gmail.com）；
   • SMTP Password：输入SMTP密码（若使用Gmail等第三方邮箱，需使用授权码而非登录密码，授权码可通过邮箱设置生成）；
4. 配置安全选项：
   • 勾选Use SMTP Authentication（启用SMTP认证）；
   • 根据SMTP服务器要求勾选Use STARTTLS（如Gmail的587端口）或Use SSL（如Gmail的465端口）；
5. 设置默认邮件内容：
   • Default Subject：输入邮件主题前缀（如[Jenkins] $PROJECT_NAME - Build #$BUILD_NUMBER - $BUILD_STATUS）；
   • Default Content：输入邮件正文（可使用变量插值，如${BUILD_STATUS}表示构建状态、${BUILD_URL}表示构建日志链接），建议使用HTML格式提升可读性；
6. 测试配置：点击Test Configuration，输入有效收件人邮箱地址，若收到测试邮件则说明配置成功。

三、配置系统管理员邮件地址

进入Manage Jenkins > Configure System，找到System Admin e-mail address字段，输入Jenkins发送通知时使用的系统邮箱地址（如jenkins@example.com），该地址将作为邮件发送者显示。

四、配置项目级邮件通知

1. 进入需要配置邮件通知的Jenkins项目，点击Configure；
2. 向下滚动至Post-build Actions部分，点击Add post-build action，选择Editable Email Notification；
3. 配置触发器（Trigger）：
   • 点击Add Trigger，选择触发邮件通知的条件（如Failure构建失败、Success构建成功、Unstable不稳定构建等），可根据需求添加多个触发器；
4. 配置收件人：
   • Recipient List：输入收件人邮箱地址（多个地址用逗号分隔，如dev1@example.com,dev2@example.com）；
   • Project Recipient List：输入项目默认收件人（可选，若未指定则使用系统默认）；
5. 自定义邮件内容（可选）：
   • Subject：修改邮件主题（可使用变量，如构建${BUILD_STATUS}: ${JOB_NAME} #${BUILD_NUMBER}）；
   • Content：修改邮件正文（可引用构建信息变量，如${FAILED_TESTS}表示失败用例、${CHANGES_SINCE_LAST_SUCCESS}表示最近提交）；
6. 保存配置：点击页面底部Save。

五、常见问题解决

• SMTP认证失败：若使用第三方邮箱（如QQ、Gmail），需确保开启SMTP服务并使用授权码代替密码（如QQ邮箱需在“设置”>“账户”中开启SMTP，生成授权码）；
• 邮件发送失败：检查SMTP服务器地址、端口是否正确，网络是否允许Jenkins访问SMTP端口（如企业防火墙可能拦截）；
• 邮件未收到：确认收件人邮箱地址正确，检查Jenkins日志（Manage Jenkins > System Log）查看邮件发送详情。