centos jenkins邮件通知怎么配置

CentOS Jenkins邮件通知配置步骤

1. 安装必要插件

首先需安装Email Extension Plugin（支持动态邮件内容）和SMTP Plugin（可选，部分版本需配合使用）。
操作路径：登录Jenkins管理界面 → 点击顶部导航栏「Manage Jenkins」→ 选择「Manage Plugins」→ 切换至「Available」标签页 → 搜索“Email Extension Plugin”并勾选 → 点击「Install without restart」（或「Download now and install after restart」）完成安装。

2. 配置全局邮件服务器（关键步骤）

安装完成后，需在「系统设置」中配置SMTP服务器信息，这是邮件发送的基础。
操作路径：「Manage Jenkins」→ 「Configure System」→ 向下滚动至Extended E-mail Notification部分（部分版本可能在「E-mail Notification」部分）：

• SMTP Server：填写SMTP服务器地址（如Gmail为smtp.gmail.com，企业邮箱替换为对应域名，如smtp.qq.com）。
• SMTP Port：填写端口（常用587（TLS加密）、465（SSL加密）或25（非加密，部分服务商禁用））。
• SMTP User Name：填写发件人邮箱地址（如your-email@gmail.com）。
• SMTP Password：填写邮箱密码或应用专用授权码（如Gmail需前往「设置→安全性→应用专用密码」生成，替代原密码）。
• 加密设置：勾选「Use SMTP Authentication」（启用认证）；根据SMTP服务器要求勾选「Use TLS」（推荐）或「Use SSL」。
• 测试配置：填写一个有效收件人邮箱（如自己的私人邮箱）→ 点击「Test Configuration」→ 若收到测试邮件则配置成功。

3. 配置系统管理员邮件（可选但建议）

用于Jenkins向管理员发送系统警报或错误通知。
操作路径：「Manage Jenkins」→ 「Configure System」→ 向下滚动至E-mail Notification部分：

• System Admin e-mail address：填写管理员邮箱地址（如admin@example.com）。
• Default Recipients：设置默认收件人（多个地址用逗号分隔，如dev-team@example.com）。
• 其他选项（如「Reply-To Address」）可根据需求配置，完成后点击「Save」。

4. 在Job中配置邮件通知（触发条件与内容定制）

进入具体Job的配置页面，添加邮件通知动作，设置触发条件和邮件内容。
操作路径：选中目标Job → 点击「Configure」→ 向下滚动至Post-build Actions→ 点击「Add post-build action」→ 选择「Editable Email Notification」：

• Recipient List：设置收件人列表（支持变量，如$BUILD_USER_EMAIL表示触发构建的用户邮箱，或多个地址用逗号分隔）。
• Subject：自定义邮件主题（可使用变量，如[${JOB_NAME}] Build #${BUILD_NUMBER} - ${BUILD_STATUS}，动态显示项目名称、构建编号和状态）。
• Content：编写邮件正文（支持HTML格式，如<h1>Build Status: ${currentBuild.result}</h1><p>Project: ${env.JOB_NAME}</p><p>Build URL: ${env.BUILD_URL}</p>，包含构建结果、项目名称、日志链接等信息）。
• Triggers：设置邮件触发条件（如「Failure」（失败时发送）、「Success」（成功时发送）、「Unstable」（不稳定时发送）、「Always」（总是发送），可根据需求勾选多个）。
• 高级设置（可选）：点击「Advanced」可配置更多选项，如「Attachments」（添加附件）、「Content Type」（内容类型，默认text/plain，如需HTML选text/html）。

5. 保存并测试

完成所有配置后，点击页面底部的「Save」按钮保存设置。
测试方法：手动触发一次Job构建（如点击「Build Now」），观察收件人邮箱是否收到符合预期的邮件（主题、内容、触发条件均需符合配置）。若未收到，可检查：

• SMTP服务器配置是否正确（地址、端口、认证信息）；
• 网络连接是否正常（Jenkins服务器能否访问SMTP服务器）；
• 邮箱是否开启了SMTP服务（如Gmail需开启「允许不够安全的应用」或使用应用专用密码）。

常见问题解决

• SMTP认证失败：若使用Gmail、QQ等第三方邮箱，需确保使用应用专用授权码而非原密码（如Gmail需前往「设置→安全性→应用专用密码」生成）。
• 邮件发送失败：检查Jenkins服务器防火墙是否允许出站连接（如开放SMTP端口），或SMTP服务器是否限制了Jenkins服务器的IP地址。
• 邮件内容不显示变量：确保变量语法正确（如${BUILD_NUMBER}而非$BUILD_NUMBER），且变量在构建上下文中有效（如$BUILD_USER_EMAIL需触发构建的用户有邮箱信息）。