2026-09-10 15:11:34 +08:00
..
2026-09-10 15:11:34 +08:00
2026-09-10 15:11:34 +08:00
2026-09-10 15:11:34 +08:00
2026-09-10 15:11:34 +08:00

测试用例使用说明

目录结构

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,连接云上真实环境