Jenkins 发送邮件

### 配置 Jenkins 发送邮件通知 为了配置 Jenkins 的邮件通知功能，需要按照以下方法操作： #### 插件安装 首先，确保已安装必要的插件来支持邮件发送功能。常用的插件包括 `Email-ext` 和 `Token Macro` 插件[^2]。这些插件提供了扩展的邮件通知能力以及动态变量的支持。 #### 系统级邮箱设置 进入 Jenkins 的全局工具配置页面 (`Manage Jenkins -> Configure System`)，找到 **E-mail Notification** 或者 **Extended E-Mail Notification** 部分进行如下配置： - **SMTP Server**: 输入 SMTP 服务器地址 (例如 Gmail 使用 smtp.gmail.com)[^1]。 - **Default User E-mail Suffix**: 如果用户的电子邮件遵循特定模式，则可以在此处定义默认后缀（如 @example.com）[^4]。 - **Use SSL/TLS**: 根据所使用的 SMTP 提供商决定是否启用加密连接[^3]。 - **SMTP Port**: 填写正确的端口号，默认情况下可能是 465（SSL）、587（TLS）或其他指定端口。 - 测试邮件发送成功与否可以通过界面中的 “Test Configuration” 功能验证连通性和正确性[^4]。 #### Job级别的邮件配置 对于具体的 Pipeline 或 FreeStyle Project，在其配置选项里添加 Post-build Actions 中的相关条目： - 设置 **Recipients**, 即接收者的电子信箱地址列表[^1]。 - 自定义 **Subject** 及 **Body** 字段的内容模板，利用内置宏 `${}` 来增强灵活性并提供上下文信息。比如： - 主题示例：“【构建结果】${PROJECT_NAME} - Build # ${BUILD_NUMBER} - ${BUILD_STATUS}!”[^4] - 正文部分可以根据需求嵌入 HTML 片段或者链接至详细的报告文件[^1]。 #### 进阶特性——附件与条件化触发器 如果希望附带额外的数据作为邮件的一部分传递出去，可以在高级设置中勾选相应选项以附加日志或是其他形式的结果文档[^4]。另外，也可以依据不同的事件源设定独立的通知策略，仅当满足某些预设标准时才激活通报机制。 ```python pipeline { agent any stages { stage('Example') { steps { echo 'Hello World' } } } post { always { emailext ( subject: "[Jenkins] ${env.JOB_NAME} - Build #${env.BUILD_NUMBER}", body: '''<p>Build has finished.</p> <ul><li>Status:${currentBuild.result}</li></ul>''', to: "[email protected]", attachLog: true, compressLog: false ) } } } ```