在Debian上配置Jenkins通知(以邮件通知为例)
1. 前提条件:安装并启动Jenkins
若尚未安装Jenkins,可通过以下命令完成安装及启动:
sudo apt update
sudo apt install jenkins
sudo systemctl start jenkins
sudo systemctl enable jenkins
2. 安装必要插件(Email Extension Plugin)
Email Extension Plugin是Jenkins功能更强大的邮件通知插件,支持动态内容、模板定制等特性:
- 登录Jenkins管理界面(如
http://your-server-ip:8080);
- 点击左侧Manage Jenkins → Manage Plugins;
- 切换至Available标签,搜索“Email Extension Plugin”;
- 勾选插件并点击Install without restart(或根据提示重启Jenkins)。
3. 配置全局邮件通知(系统级设置)
全局配置用于设置SMTP服务器、发件人信息等通用参数:
- 进入Manage Jenkins → Configure System;
- 向下滚动至Extended E-mail Notification部分(若使用自带邮件功能,则在“邮件通知”部分配置);
- 填写SMTP服务器信息:
- SMTP Server:如Gmail为
smtp.gmail.com,企业邮箱替换为对应SMTP地址;
- SMTP Port:通常TLS为
587,SSL为465;
- Use SMTP Authentication:勾选“启用”;
- User Name:SMTP账号(如个人邮箱
your-email@gmail.com);
- Password:SMTP密码(如Gmail需使用应用专用密码);
- Default Subject:邮件主题前缀(如
[Jenkins]);
- Default Content Type:内容格式(推荐
text/html以支持富文本);
- (可选)勾选Use SSL/TLS:根据SMTP服务器要求选择(如Gmail需勾选TLS);
- 点击Test Configuration,输入测试邮箱地址,验证配置是否正确。
4. 配置Job级别的邮件通知(项目级设置)
为具体构建任务设置邮件触发条件和收件人:
- 进入需要配置的Job页面,点击Configure;
- 向下滚动至Post-build Actions部分;
- 点击Add post-build action,选择Editable Email Notification;
- 配置收件人与触发条件:
- Recipient List:指定收件人邮箱(多个地址用逗号分隔,如
dev1@example.com,dev2@example.com);
- Triggers:设置邮件发送时机(如“Failure”构建失败时、“Success”构建成功时、“Unstable”不稳定时,可多选);
- 自定义邮件内容(可选):
- Subject:支持变量(如
${JOB_NAME} - Build #${BUILD_NUMBER} - ${BUILD_STATUS},表示“任务名-构建编号-状态”);
- Content:支持HTML格式(如
<h1>Build Notification</h1><p>Project: ${JOB_NAME}</p><p>Status: ${BUILD_STATUS}</p>);
- (可选)点击Advanced Settings,可配置附件、不同触发条件的差异化内容等。
5. 测试通知功能
- 手动触发Job构建(点击Build Now);
- 构建完成后,检查收件人邮箱是否收到通知邮件;
- 若未收到,可查看Jenkins日志(
/var/log/jenkins/jenkins.log)排查错误(如SMTP认证失败、网络连接问题)。
注意事项
- 若使用Gmail等第三方邮箱,需确保已开启“允许不够安全的应用”或使用应用专用密码;
- 邮件内容中的变量可根据需求调整(如
${BUILD_LOG}插入构建日志片段);
- 如需更复杂的模板,可在Extended E-mail Notification的“Default Content”中编辑全局模板,或在Job配置中覆盖。