如何配置CentOS Jenkins的邮件通知
导读:一、安装必要插件 在Jenkins管理界面,点击Manage Jenkins > Manage Plugins,进入“Available”标签页,搜索并安装以下插件: Email Extension Plugin(必选,支持定制邮件...
一、安装必要插件
在Jenkins管理界面,点击Manage Jenkins > Manage Plugins,进入“Available”标签页,搜索并安装以下插件:
- Email Extension Plugin(必选,支持定制邮件内容、触发条件和接收者);
- SMTP Plugin(可选,若Email Extension Plugin未自动安装SMTP插件则需单独安装)。
二、配置全局SMTP邮件设置
- 进入Manage Jenkins > Configure System,向下滚动至Extended E-mail Notification部分;
- 勾选Enable extended E-mail notification(启用扩展邮件通知);
- 填写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等第三方邮箱,需使用授权码而非登录密码,授权码可通过邮箱设置生成);
- SMTP Server:输入SMTP服务器地址(如Gmail为
- 配置安全选项:
- 勾选Use SMTP Authentication(启用SMTP认证);
- 根据SMTP服务器要求勾选Use STARTTLS(如Gmail的587端口)或Use SSL(如Gmail的465端口);
- 设置默认邮件内容:
- Default Subject:输入邮件主题前缀(如
[Jenkins] $PROJECT_NAME - Build #$BUILD_NUMBER - $BUILD_STATUS
); - Default Content:输入邮件正文(可使用变量插值,如
${ BUILD_STATUS}
表示构建状态、${ BUILD_URL}
表示构建日志链接),建议使用HTML格式提升可读性;
- Default Subject:输入邮件主题前缀(如
- 测试配置:点击Test Configuration,输入有效收件人邮箱地址,若收到测试邮件则说明配置成功。
三、配置系统管理员邮件地址
进入Manage Jenkins >
Configure System,找到System Admin e-mail address字段,输入Jenkins发送通知时使用的系统邮箱地址(如jenkins@example.com
),该地址将作为邮件发送者显示。
四、配置项目级邮件通知
- 进入需要配置邮件通知的Jenkins项目,点击Configure;
- 向下滚动至Post-build Actions部分,点击Add post-build action,选择Editable Email Notification;
- 配置触发器(Trigger):
- 点击Add Trigger,选择触发邮件通知的条件(如
Failure
构建失败、Success
构建成功、Unstable
不稳定构建等),可根据需求添加多个触发器;
- 点击Add Trigger,选择触发邮件通知的条件(如
- 配置收件人:
- Recipient List:输入收件人邮箱地址(多个地址用逗号分隔,如
dev1@example.com,dev2@example.com
); - Project Recipient List:输入项目默认收件人(可选,若未指定则使用系统默认);
- Recipient List:输入收件人邮箱地址(多个地址用逗号分隔,如
- 自定义邮件内容(可选):
- Subject:修改邮件主题(可使用变量,如
构建${ BUILD_STATUS} : ${ JOB_NAME} #${ BUILD_NUMBER}
); - Content:修改邮件正文(可引用构建信息变量,如
${ FAILED_TESTS}
表示失败用例、${ CHANGES_SINCE_LAST_SUCCESS}
表示最近提交);
- Subject:修改邮件主题(可使用变量,如
- 保存配置:点击页面底部Save。
五、常见问题解决
- SMTP认证失败:若使用第三方邮箱(如QQ、Gmail),需确保开启SMTP服务并使用授权码代替密码(如QQ邮箱需在“设置”> “账户”中开启SMTP,生成授权码);
- 邮件发送失败:检查SMTP服务器地址、端口是否正确,网络是否允许Jenkins访问SMTP端口(如企业防火墙可能拦截);
- 邮件未收到:确认收件人邮箱地址正确,检查Jenkins日志(Manage Jenkins > System Log)查看邮件发送详情。
声明:本文内容由网友自发贡献,本站不承担相应法律责任。对本内容有异议或投诉,请联系2913721942#qq.com核实处理,我们将尽快回复您,谢谢合作!
若转载请注明出处: 如何配置CentOS Jenkins的邮件通知
本文地址: https://pptw.com/jishu/718963.html