atlantbh/owl

Owl

概述

Owl是一款专注于测试结果报告与展示的工具，能够帮助用户可视化和管理测试数据。它支持PostgreSQL数据库存储测试结果，可与rspec2db gem配合将RSpec测试结果写入数据库，为团队提供清晰的测试执行情况视图。

核心功能

• 测试运行管理：查询所有测试运行或指定构建的测试运行数据
• 测试用例查看：获取特定测试运行下的所有测试用例详情
• 测试步骤展示：按分组查看测试用例的具体步骤及执行结果
• 测试套件管理：支持测试套件的增删改查，以及获取套件的统计数据（如总用例数、失败数等）
• JUnit报告导入：解析并持久化JUnit格式的测试结果文件

使用场景

• CI/CD流水线中展示自动化测试结果，帮助团队快速定位问题
• 团队内部共享测试数据，跟踪测试用例的执行历史与趋势
• 生成测试统计报告，辅助质量评估与决策

配置说明

前提条件

• 需准备PostgreSQL数据库（可通过rspec2db gem生成格式化测试结果）
• 运行环境需安装Java JRE

Docker部署示例

Docker Compose

直接启动Owl与PostgreSQL服务：

bash
docker-compose up

服务默认在8090端口可用，访问地址：http://localhost:8090

Docker Run

1. 构建镜像：

bash
docker build -t atlantbh/owl .

2. 启动容器（默认配置）：

bash
docker run --name owl -d -p 8090:8090 atlantbh/owl

3. 使用外部配置文件启动：

bash
docker run --name owl -d -p 8090:8090 -v /本地路径/application.properties:/app/application.properties atlantbh/owl --spring.config.location=/app/application.properties

API参考

• 获取所有测试运行：GET /api/v1/test-runs（支持build参数过滤）
• 获取测试用例：GET /api/v1/test-runs/{TEST_RUN_ID}/test-cases
• 获取测试步骤：GET /api/v1/test-runs/{TEST_RUN_ID}/test-steps?group={TEST_GROUP_NAME}
• JUnit报告导入：POST /api/v1/test-runs/{TEST_RUN_ID}/test-cases/junit-xml-report（请求体为JUnit XML文件）
• 测试套件统计：GET /api/v1/test-suites/{testSuiteId}/statistics