第10章 零基础接口自动化到 Jenkins 持续集成【定时监控与邮件告警完整落地】

第10章 定时监控与邮件告警完整落地

本章目标

实现"每天自动跑 + 自动邮件通知"，形成真正可运营的质量监控。

1. 配置 Jenkins 定时触发

当前 Jenkinsfile 已有：

triggers {
  cron('H 9,13,18 * * *')
}

含义：每天 9/13/18 点自动执行。

2. 配置邮件凭据

在 Jenkins 凭据中新增：

• smtp-user：邮箱账号
• smtp-pass：邮箱授权码

它们会被 Send Mail Report 阶段读取。

3. 邮件参数建议

• MAIL_RECEIVERS：多个收件人用逗号分隔
• MAIL_SUBJECT：例如"接口自动化测试报告"
• SMTP_HOST：如 smtp.example.com
• SMTP_PORT：如 465

4. 参数到底配在哪里（避免混淆）

参数	建议配置位置	说明
SMTP_USER	Jenkins Credentials（smtp-user）	敏感信息，不要写死在仓库
SMTP_PASS	Jenkins Credentials（smtp-pass）	敏感信息，不要写死在仓库
MAIL_RECEIVERS	Jenkinsfile 的 environment 或 Job 环境变量	收件人列表
MAIL_SUBJECT	Jenkinsfile 的 environment 或 Job 环境变量	邮件主题
SMTP_HOST	Job 环境变量（或脚本默认值）	Jenkinsfile 已做默认兜底
SMTP_PORT	Job 环境变量（或脚本默认值）	默认 465

当前项目中：

• SMTP_USER/SMTP_PASS 由 withCredentials 注入
• MAIL_RECEIVERS/MAIL_SUBJECT 在 Jenkinsfile environment 已给出默认值
• SMTP_HOST/SMTP_PORT 在 Send Mail Report 阶段 shell 脚本里有默认值兜底

5. 验证告警链路

1. 手动执行一次构建
2. 看 Send Mail Report 日志是否显示 sent
3. 检查邮箱是否收到通知
4. 邮件中是否有 Jenkins 构建链接与报告入口

6. 监控运营建议

• 失败后 10 分钟内查看日志并登记原因
• 每周统计失败接口 Top N 并复盘
• 用例和业务版本一起维护，避免"历史用例失真"

7. 课程结业标准

满足以下 5 项即结业：

1. 本地可稳定执行 python3 run.py
2. 可独立新增 YAML 用例并断言
3. 可处理 token 参数关联
4. Jenkins 可自动拉代码跑测试并归档报告
5. 定时任务与邮件通知稳定运行

结语

你已经完成了从"0 代码基础"到"自动化框架 + 云端持续集成"的完整闭环。

下一步建议：按业务模块持续补用例，让自动化真正服务发布质量。