Test Suites

通用业务测试 Skill 与独立项目套件。业务仓库通过部署流水线调用固定版本的测试代码。

skills/test-skill/   通用 v1 Skill、JSON 接口执行器和模板
projects/crm/       CRM candidate-v2 目录、Python/浏览器适配及 Drone 示例

两种套件格式不同:通用 v1 的 JSON 定义 HTTP 步骤;CRM v2 的 JSON 是用例目录,具体执行逻辑在 Python/浏览器适配中。不要交叉使用执行入口。

工具验证

PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s skills/test-skill/tests -v
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s projects/crm -p test_runner.py -v

CRM 本地隔离运行

需要 Python 3.10+、Git、Node.js、兼容 CRM go.mod 的 Go,以及已准备好的 Go 模块缓存。执行器不自动联网下载依赖。

python3 projects/crm/run.py --local --repo /path/to/crm --commit HEAD --allow-write --output reports/new-run

/path/to/crm 替换为业务代码目录,输出目录必须尚不存在。运行会创建临时源码副本,使用 JSON 存储、空通知地址、临时凭据和本机监听;不会修改原业务工作区。

Drone 接入

若业务仓库的 .drone.yml 是 kind: template / load: mailo.jsonnet,不要向入口文件直接添加 steps;应在共享 Jsonnet 模板生成的流水线中接入。对应的默认关闭补丁、部署就绪校验和启用说明位于 ci/templates/。该候选模板尚未发布到 Drone,当前也没有 Mailo 业务套件。

将 projects/crm/ci/drone.steps.example.yml 的步骤合并到业务仓库现有 .drone.yml 的 steps 中:部署成功并确认服务就绪 → 拉取固定提交的测试仓库 → 执行 CRM 套件。示例为 Docker 流水线,使用 promote/staging 条件;需要改成与真实部署步骤一致的条件。已有依赖图须整体核对;顺序流水线可按此顺序追加并移除示例中的 depends_on。

在业务仓库的 Drone Secrets 中配置:

名称 用途
test_repo_read_key 只读访问测试仓库的 SSH 部署私钥
test_repo_known_hosts 管理员核验的 Gitea SSH known_hosts 条目
crm_test_url Runner 能访问的专用 HTTPS 测试环境地址
crm_admin_token 专用管理员测试凭据
crm_viewer_token 专用只读角色测试凭据

示例只读取 SSH 密钥到临时容器目录,关闭命令回显,严格核验主机密钥;不会将凭据放入共享工作区或 URL。

测试代码固定拉取 TEST_SUITE_COMMIT 指定的提交。当前示例固定到 bootstrap 提交;该版本没有已确认的 projects/crm/review.json,启用前必须完成预期审核并将审批文件提交到测试仓库,再更新固定提交。不能把空的 review.example.json 当作批准。

报告上传沿用现有存储。若已有 S3/MinIO,可参考 projects/crm/ci/drone.report-upload.example.yml 配置私有桶及所列 Secrets,上传步骤在测试成功、失败时均执行。其他存储使用原有插件;示例不会创建存储或公开报告。配置错误发生在执行前时可能没有报告,检查失败步骤日志,不能伪造通过结果。

Drone 官方参考:步骤依赖、Secrets、变量转义、S3/MinIO 插件。

远端执行需要全部选中预期已确认、HTTPS、专用凭据以及独占且初始为空的测试环境;写测试须显式授权。凭据使用 Drone Secrets,不写进代码或命令行。

当前 CRM 仍是候选套件:77 条全部保留 draft,存在断言不匹配、预期未明确和浏览器/时钟/性能阻塞,不构成上线通过结论。浏览器适配脚本仅完成语法检查,不能将其视为已经执行通过。

源码与套件纳入版本管理;执行报告、临时数据、账号凭据和业务仓库代码不放入本仓库。

Description
No description provided
Readme 128 KiB
Languages
Python 84.6%
Jsonnet 9.9%
JavaScript 5.1%
Go 0.2%
Shell 0.2%