当前位置：首页 > news >正文

【Hermes系列7】我把 Hermes 接入了 Jenkins：回归测试从 3 天到 30 分钟

news 2026/4/16 2:00:22

01 这是 Hermes 系列的第 7 篇，也是企业落地关键篇。

前 6 篇我们解决了：本地跑通、场景实战、工程化。但真实企业里，还有一个绕不开的问题：

你本地跑得再好，怎么让团队每个人都用上？怎么保证每天按时执行？怎么让报告自动触达相关人员？

答案只有一个：接入 CI/CD。

作为 14 年测试负责人，我带过 3 个团队的自动化转型。今天这篇，我把 Hermes 接入 Jenkins 的完整过程分享给你。

包括：

为什么选 Jenkins（vs GitLab CI/GitHub Actions）

环境配置（浏览器、依赖、权限）
Pipeline 编写（可直接复制）
报告集成（HTML 展示 + 历史趋势）
失败通知（邮件 + 飞书）
常见坑点（我踩过的 5 个）

我承诺一个结果：你照着本文走，2 小时内能让 Hermes 测试在 CI 环境跑起来。

02

为什么选 Jenkins？

先回答一个常见问题：为什么不用 GitLab CI 或 GitHub Actions？

对比维度	Jenkins	GitLab CI	GitHub Actions
部署方式	自建（内网友好）	依赖 GitLab	依赖 GitHub
插件生态	最丰富	中等	中等
定制能力	最强	中等	中等
学习成本	高	中	低
企业采用率	70%+	20%	10%

我的选择逻辑：

<ul> <li>内网环境 → Jenkins（自建）</li> <li>用 GitLab 且能接受 SaaS → GitLab CI</li> <li>开源项目 → GitHub Actions</li> </ul>

这篇用 Jenkins 示范，因为企业采用率最高。如果你用其他 CI，逻辑相通，改下 Pipeline 语法即可。

03

环境准备（CI 服务器）

硬件要求：

配置	最低	推荐
CPU	4 核	8 核
内存	8GB	16GB
磁盘	50GB	100GB SSD
浏览器	Chromium	Chromium + Firefox

软件要求：Ubuntu 20.04+、Java 11+、Python 3.8+、Node.js 18+、Git、Chromium。

安装步骤（完整命令见源码目录）：

1. 安装 Java 和 Jenkins
2. 获取初始密码，访问 Jenkins
3. 安装 Python 和 Hermes
4. 配置权限和中文字体

💡 提示：完整安装命令已整理到源码目录的install.sh脚本，加testzhouzhou获取。

04

Jenkins Pipeline 配置

创建新任务：

1. 登录 Jenkins → 新建任务 → 选择"Pipeline"
2. 任务名：Hermes-Regression-Test
3. 勾选"Discard old builds"（保留最近 10 次）

Pipeline 核心结构：

Pipeline 包含 6 个阶段： 1. 拉取代码 - 从 Git 获取测试脚本 2. 准备环境 - 安装依赖和浏览器 3. 准备测试数据 - 生成测试所需数据 4. 执行测试 - 运行 Hermes 测试（30 分钟超时） 5. 生成报告 - 生成可视化 HTML 报告 6. 清理数据 - 清理测试产生的数据

完整 Pipeline 脚本已整理到源码目录的Jenkinsfile，包含：

环境变量配置
6 个执行阶段
失败处理和报告归档
邮件/飞书通知集成

💡 提示：复制源码目录的Jenkinsfile到你的项目，修改 TEST_BASE_URL 等配置即可使用。加testzhouzhou获取。

关键插件：

插件名	用途
Publish HTML reports	发布 HTML 报告
Email Extension	邮件通知
Pipeline	Pipeline 支持
Git	Git 集成

05

测试报告集成

报告生成脚本已整理到源码目录的generate_summary_report.py，功能包括：

读取 JSON 测试报告
生成可视化 HTML 报告
显示通过率统计
列出每个用例的详细结果

报告效果：

总用例数、通过数、失败数、通过率
绿色/红色区分通过/失败状态
用例详情表格（编号、名称、状态、结果说明）

💡 提示：完整报告生成脚本已整理到源码目录，加testzhouzhou获取。

07

实测演示（2026-04-13 真实执行）

测试环境：

Jenkins 2.541.3（Docker 部署）
Python 3.11（Docker 容器）
Ubuntu 24.04
Hermes Agent（本地开发版）

测试用例：5 个 E2E 场景

TC001: 用户登录
TC002: 创建商品
TC003: 查询商品列表
TC004: 创建订单
TC005: 仪表盘数据加载

执行结果：

指标	数值
总用例数	5
通过	4
失败	1
通过率	80.0%
执行时间	约 30 秒

失败分析：

TC004（创建订单）失败 - 原因：库存不足
这是预期内的失败，用于验证失败用例捕获机制

Jenkins 任务界面：

*（上图：Jenkins 中创建的 Hermes 回归测试任务，可以看到构建历史）*

测试报告：

*（上图：Hermes 生成的 HTML 测试报告，包含用例详情和执行时间）*

关键数据：

TC001（用户登录）：1250ms ✅
TC002（创建商品）：2340ms ✅
TC003（查询商品列表）：890ms ✅
TC004（创建订单）：3200ms ❌
TC005（仪表盘数据）：1560ms ✅

实测结论：
1. ✅ Jenkins Pipeline 可以正常执行 Hermes 测试
2. ✅ 测试报告可以正确生成并归档
3. ✅ 失败用例可以被正确捕获和展示
4. ⚠️ 需要使用 Docker 容器来运行 Python 环境（避免 Jenkins 主节点依赖问题）

08

失败通知配置

邮件通知：

在 Pipeline 的post.failure中添加邮件发送逻辑，包含：

任务名称和构建号
通过率统计
失败用例列表
Jenkins 详情链接

飞书通知：

参考源码目录的feishu_notification.groovy，发送交互式卡片消息，包含：

红色告警标题
任务信息和通过率
"查看详情"按钮

💡 提示：完整通知配置已整理到源码目录，加testzhouzhou获取。

07

定时执行配置

方案 A：Jenkins 定时触发：

GROOVY复制

// 在 Pipeline 开头添加触发器

pipeline { agent any triggers { // 工作日每天早上 9 点执行 cron('0 9 * * 1-5') // 或者每晚 10 点执行 // cron('0 22 * * *') } // ... 其他配置 }

方案 B：Hermes cron + Jenkins：

<h1>在 CI 服务器上配置 Hermes cron</h1> hermes cron create "0 9 * * 1-5" \\ --name "jenkins-regression-test" \\ --script "/home/hermes/run_regression.sh" \\ "基于测试报告 JSON，生成适合飞书群的简短摘要"

08

我踩过的 5 个坑

坑 1：浏览器启动失败

问题：Jenkins 里 Playwright 无法启动浏览器 原因：缺少依赖库 解决： sudo apt install libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libasound2 -y

坑 2：中文乱码

TEXT复制

问题：报告中文显示为方框 原因：CI 环境缺少中文字体 解决： sudo apt install fonts-wqy-zenhei fonts-wqy-microhei -y

坑 3：权限不足

问题：Jenkins 用户无法执行 Python 脚本 原因：权限配置问题 解决： sudo visudo <h1>添加：jenkins ALL=(ALL) NOPASSWD: /home/hermes/hermes-env/bin/python</h1>

坑 4：测试数据污染

问题：多次执行后测试数据越来越多 原因：缺少清理机制 解决： <ul> <li>统一前缀（E2E_AUTO_）</li> <li>每次执行前清理旧数据</li> <li>执行后清理本次数据</li> </ul>

坑 5：报告看不到

问题：Jenkins 上 HTML 报告无法访问 原因：Jenkins 安全策略限制 解决： 系统管理 → 脚本命令行 → 执行： System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")

09

效果对比

接入前：

指标	数值
回归测试时间	3 天（2 人）
执行频率	每版本 1 次
覆盖率	60%
问题发现	上线后
报告触达	手动发送

接入后：

指标	数值	提升
回归测试时间	30 分钟	93%↓
执行频率	每天 1 次	20 倍↑
覆盖率	90%	50%↑
问题发现	提交后 30 分钟	提前 3 天
报告触达	自动通知	无需人工

ROI 计算：

TEXT复制

投入： <ul> <li>CI 服务器：500 元/月</li> <li>配置时间：3 天</li> <li>维护时间：2 小时/周</li> </ul> 收益： <ul> <li>节省人力：2 人 × 3 天/版本 × 2 版本/月 = 12 人天/月</li> <li>提前发现问题：减少线上故障 80%</li> <li>团队信心：敢于重构、敢于发版</li> </ul> 结论：1 个月回本，之后纯赚