119 lines
4.8 KiB
Markdown
119 lines
4.8 KiB
Markdown
|
# QUIC 真实端到端测试
|
|||
|
|
|
|||
|
|
本目录验证生产 QUIC client 代码与
|
|||
|
|
[`test/quic_gateway/`](../quic_gateway/) 中真实 MsQuic Server 的互操作，不使用
|
|||
|
|
fake transport，也不要求连接物理设备。
|
|||
|
|
|
|||
|
|
## 测试矩阵
|
|||
|
|
|
|||
|
|
| CTest 名称 | 进程边界 | 覆盖内容 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| `cmvr_quic_msquic_e2e_test` | 测试进程内同时运行 Gateway 和生产 `QuicEdgeService` | TLS/ALPN、注册、DeviceManager 合成快照、至少两次心跳 ACK、H.264/AAC descriptor 精确字段、真实 DATAGRAM、分片、序列号、flags、长度与载荷哈希 |
|
|||
|
|
| `cmvr_es_quic_process_smoke_test` | 分别启动测试 Gateway 和真实 `cmvr_es` 子进程 | 临时配置加载、`QuicEdgeTask` 工厂和生命周期、节点注册、IP、禁用设备过滤、已启用设备创建失败上报、本地心跳周期、至少两次心跳 ACK、SIGTERM 安全退出 |
|
|||
|
|
|
|||
|
|
第一项向生产 `MediaSourceHub` 注册两个有界 synthetic source：
|
|||
|
|
|
|||
|
|
- 2500 字节的 H.264 Annex B IDR 视频帧，用于覆盖 DATAGRAM 分片；
|
|||
|
|
- 带 ADTS header 的 AAC-LC 48 kHz 双声道音频帧。
|
|||
|
|
|
|||
|
|
测试先发送 discovery 帧触发可靠 descriptor，确认 Gateway 已安装两个轨道后，
|
|||
|
|
再发送 priming 和 validation 帧，因此不会把 reliable stream 与 DATAGRAM 的
|
|||
|
|
跨通道乱序误报成失败。最终 validation 帧按轨道精确校验 sequence、字节数、
|
|||
|
|
flags 和 FNV-1a 载荷哈希。
|
|||
|
|
|
|||
|
|
它验证的是媒体传输和协议封装，不验证摄像头、麦克风或编码器驱动。第二项生成
|
|||
|
|
一棵临时 Proto Text 配置树，配置两个禁用设备和一个无配置文件的已启用设备，
|
|||
|
|
只启用 QUIC 任务；它会验证禁用设备不会出现在 heartbeat 中、已启用设备的创建
|
|||
|
|
失败仍会作为异常行上报，并让 Gateway 返回零周期以保留边缘配置；
|
|||
|
|
测试结束后临时
|
|||
|
|
目录自动清理，不会修改 `cmvr-es/config/`、`output/bin/config/` 或
|
|||
|
|
`output/bin/model/`。
|
|||
|
|
|
|||
|
|
## 构建并运行
|
|||
|
|
|
|||
|
|
先按根目录 README 构建固定版本的仓库内 MsQuic：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
script/build_msquic.sh \
|
|||
|
|
--arch x86 \
|
|||
|
|
--version 2.5.9 \
|
|||
|
|
--jobs "$(nproc)" \
|
|||
|
|
--clean
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
再配置真实后端和测试：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cmake -S . -B build-quic \
|
|||
|
|
-DCMAKE_BUILD_TYPE=Release \
|
|||
|
|
-DCMVR_ARCH=x86 \
|
|||
|
|
-DBUILD_TESTING=ON \
|
|||
|
|
-DCMVR_BUILD_QUIC_TEST_GATEWAY=ON \
|
|||
|
|
-DCMVR_INSTALL_DEFAULT_RUNTIME_ASSETS=OFF
|
|||
|
|
|
|||
|
|
cmake --build build-quic -j"$(nproc)"
|
|||
|
|
ctest \
|
|||
|
|
--test-dir build-quic \
|
|||
|
|
--output-on-failure \
|
|||
|
|
-R 'cmvr_quic_msquic_e2e_test|cmvr_es_quic_process_smoke_test'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
要求：
|
|||
|
|
|
|||
|
|
- `dependency/x86/third_party/msquic/v2.5.9` 已完整生成；
|
|||
|
|
- 本机可执行 `openssl`，CMake 用它在
|
|||
|
|
`build-quic/test/certs/` 生成 7 天有效的 loopback 证书；
|
|||
|
|
- 完整进程冒烟需要 Python 3.10 或更高版本；
|
|||
|
|
- 运行环境允许在 `127.0.0.1` 创建 UDP listener 和 QUIC 连接。
|
|||
|
|
|
|||
|
|
测试被标记为 `RUN_SERIAL`，避免端口、证书和进程日志互相干扰。也可按 label
|
|||
|
|
运行：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
ctest --test-dir build-quic --output-on-failure -L 'quic|e2e'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
CTest 会为构建树补齐仓库内共享库搜索路径。人工启动 Gateway 时应使用 CMake
|
|||
|
|
生成的
|
|||
|
|
`build-quic/test/quic_gateway/run_cmvr_quic_test_gateway` 包装器，而不是直接
|
|||
|
|
执行裸二进制；参数和 summary 字段见
|
|||
|
|
[`test/quic_gateway/README.md`](../quic_gateway/README.md)。
|
|||
|
|
|
|||
|
|
## 通过条件
|
|||
|
|
|
|||
|
|
真实媒体 E2E 至少要求：
|
|||
|
|
|
|||
|
|
- 一次注册被接受，且至少两个心跳被精确 ACK；
|
|||
|
|
- 一个媒体 session 和两个轨道描述到达，且 codec、payload format、分辨率或
|
|||
|
|
采样参数、generation 和 codec config 与源描述完全一致；
|
|||
|
|
- 视频和音频 validation 帧均完成重组，最大 sequence、track ID、长度、flags
|
|||
|
|
和载荷哈希与发送值完全一致；
|
|||
|
|
- Edge 与 Gateway 的 session ID 一致；
|
|||
|
|
- `protocol_violations == 0`，两端均无运行时错误；
|
|||
|
|
- client、连接、listener 和后台队列能够有序停止。
|
|||
|
|
|
|||
|
|
完整进程冒烟至少要求：
|
|||
|
|
|
|||
|
|
- `cmvr_es` 日志出现 `[QuicEdgeTask] Started`；
|
|||
|
|
- 没有使用不可用占位后端；
|
|||
|
|
- Gateway 接受 `cmvr-process-smoke` 节点注册；
|
|||
|
|
- 收到并回复至少两个心跳；
|
|||
|
|
- 心跳中的 Manager 元数据正确，两个禁用设备均未上报，已启用设备的创建失败
|
|||
|
|
以 `ERROR` 行上报；
|
|||
|
|
- Gateway 和 `cmvr_es` 都以退出码 0 结束。
|
|||
|
|
|
|||
|
|
失败时进程冒烟会输出 Gateway 与 `cmvr_es` 的完整临时日志，便于区分依赖加载、
|
|||
|
|
UDP 监听、TLS、协议或生命周期问题。
|
|||
|
|
|
|||
|
|
## 不覆盖的能力
|
|||
|
|
|
|||
|
|
这些测试不替代：
|
|||
|
|
|
|||
|
|
- 真机摄像头、麦克风和厂商 SDK 验证；
|
|||
|
|
- 真实编码器码流质量和长时间压力测试；
|
|||
|
|
- 丢包、抖动、NAT、防火墙和弱网测试；
|
|||
|
|
- Java 生产 Gateway、鉴权、状态持久化和浏览器转发；
|
|||
|
|
- mTLS、生产 CA、业务 token 或设备 ACL。
|
|||
|
|
|
|||
|
|
测试证书和 `allow_insecure` 只用于本机 loopback，不得用于生产环境。
|