测试用例使用说明
目录结构
testcases/
├── x5_cases/ # X5 平台测试用例(独立目录)
│ ├── run.sh # X5 运行脚本
│ ├── x5_runner.py # X5 执行引擎
│ ├── models/ # X5 模型文件
│ │ └── yolov8_640x640_nv12.bin
│ ├── tc_01_x5_single_perf.py
│ ├── tc_02_x5_multi_model_perf.py
│ └── tc_03_x5_burst.py
│
└── s100_cases/ # S100 平台测试用例(独立目录)
├── run.sh # S100 运行脚本
├── s100_runner.py # S100 执行引擎
├── models/ # S100 模型文件
│ └── yolo11n_detect_nashe_640x640_nv12.hbm
├── tc_01_s100_single_perf.py
└── tc_02_s100_burst.py
重要:运行路径要求
所有脚本必须在各自目录下运行,不能从其他目录调用。
正确用法
# X5 测试 - 先进入 x5_cases 目录
cd x5_cases
bash run.sh
# S100 测试 - 先进入 s100_cases 目录
cd s100_cases
bash run.sh
错误用法
# 错误!不能从其他目录调用
bash testcases/x5_cases/run.sh
bash onboard_inference/testcases/x5_cases/run.sh
使用示例
X5 平台
cd x5_cases
# 运行所有 X5 测试用例
bash run.sh
# 运行单个用例(通过前缀匹配)
bash run.sh tc_01
bash run.sh tc_03
# 使用本地环境
APP_ENV=board_dev_all_local bash run.sh
# 自定义并发数(仅压测用例生效)
BURST_COUNT=16 bash run.sh
S100 平台
cd s100_cases
# 运行所有 S100 测试用例
bash run.sh
# 运行单个用例
bash run.sh tc_01
# 使用本地环境
APP_ENV=board_dev_all_local bash run.sh
# 自定义并发数
BURST_COUNT=16 bash run.sh
测试链路
每个测试用例执行完整的链路验证:
JuiceFS 上传 → MQ 发布 → 消费者挂载 → Docker 推理 → 结果回写 → MQ 回调
文件说明
| 文件 | 说明 |
|---|---|
run.sh |
批量运行脚本,必须在所在目录执行 |
*_runner.py |
测试执行引擎,处理 JuiceFS/MQ 交互 |
models/ |
该平台的模型文件目录 |
tc_*.py |
具体测试用例 |
环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
APP_ENV |
board_dev |
应用环境配置 |
BURST_COUNT |
8 |
压测用例的并发任务数 |
JuiceFS 环境差异说明
测试用例支持两种 JuiceFS 环境,通过 APP_ENV 切换:
1. 云上商业版(board_dev)
- JuiceFS 地址:
dev-01-dcloudfs(地瓜云) - Token: 需要
backend/private.py中的有效商业 token - 挂载方式:
juicefs-private mount -d --token <商业token> --subdir dcloud/xxx dev-01-dcloudfs /mnt/xxx
2. 本地自建版(board_dev_all_local)
- JuiceFS 地址: 本地 Redis 元数据(
redis://127.0.0.1:6379/1) - Token: 同样读取
backend/private.py,但 wrapper 会自动忽略,转换为本地 Redis 连接 - 挂载方式:
# wrapper 内部自动转换,对上层透明 juicefs-private mount -d --token <任意> --subdir dcloud/xxx dev-01-dcloudfs /mnt/xxx # ↓ 实际转换为: juicefs mount -d --meta-url redis://127.0.0.1:6379/1 /mnt/xxx
3. 关键区别
| 特性 | 云上商业版 | 本地自建版 |
|---|---|---|
| 需要真实 token | ✅ 是 | ❌ 否(wrapper 忽略) |
| 网络要求 | 需要连接地瓜云 | 纯本地 |
| 数据持久化 | 云端 S3 | 本地 Redis + 目录 |
| 速度 | 取决于网络 | 本地更快 |
4. 本地 JFS 环境搭建
# 一键搭建本地 JuiceFS 环境
sudo bash scripts/setup-dev-jfs.sh
# 一键搭建本地 RabbitMQ 环境
sudo bash scripts/rabbitmq-setup.sh
5. 使用建议
- 开发调试: 使用
APP_ENV=board_dev_all_local,速度快,不依赖外网 - 联调测试: 使用
APP_ENV=board_dev,连接云上真实环境