40 行
1.4 KiB
Markdown
40 行
1.4 KiB
Markdown
# CI 回归报告归档说明（P13-6）
|
||
|
||
更新时间：2026-02-12
|
||
|
||
## 目标
|
||
|
||
在 `ci-regression` 流水线中产出并归档结构化回归报告，确保每次回归可追溯到具体 `run_id` 与 `commit SHA`。
|
||
|
||
## 产物
|
||
|
||
- 回归脚本输出：`/tmp/hyb-oa-regression/report.json`
|
||
- Artifact 名称：`regression-report-<run_id>-<sha>`
|
||
- JSON 契约：`schema_version = "1.0"`
|
||
|
||
## 字段约定
|
||
|
||
报告包含以下关键字段：
|
||
|
||
- `schema_version`
|
||
- `generated_at`
|
||
- `git.sha`
|
||
- `git.branch`
|
||
- `overall.status | duration_ms | passed | failed | skipped | total`
|
||
- `steps[]`：`id | name | enabled | status | exit_code | duration_ms | started_at | ended_at | command`
|
||
|
||
## 回归命令
|
||
|
||
在 CI 中使用：
|
||
|
||
```bash
|
||
RUN_AUDIT_REGRESSION=1 RUN_OCR_REGRESSION=1 ./scripts/regression-all.sh --json-report /tmp/hyb-oa-regression/report.json
|
||
```
|
||
|
||
## 排障建议
|
||
|
||
- **优先查看 Job Summary**：流水线完成后会自动在 GitHub Actions 运行页面的 Summary 面板输出结构化摘要，可直接看到由于哪些 `steps` 导致阻断失败。
|
||
- 回归大面积或异常失败时，请优先下载 artifact 中的 `report.json` 进一步比对 `overall.failed` 与具体抛出的退出码。
|
||
- 若报告未生成，检查回归步骤是否在脚本启动前失败（例如服务未就绪，数据库连不上）。
|
||
- 若报告字段缺失，优先比对 `server/scripts/lib/regression-report.sh` 与 schema 版本。
|