chore: normalize test-server health governance

2026-05-21 14:21:27 +08:00
parent 3b67df19e7
commit d79c11fb15
5 changed files with 96 additions and 6 deletions
@@ -0,0 +1,24 @@
+# CloudSearch 测试服治理说明
+
+## 当前测试服定位
+
+`/root/cloudsearch_deploy` 是当前 Docker Compose 实际运行目录。`CloudSearch_App` 的 compose label 与挂载均指向该目录。
+
+## 健康检查口径
+
+`Video Parser` 当前仍是待开发/未部署能力。测试服健康判断应区分核心必需组件与可选/开发中能力。
+
+源码中的 `computeOverallHealth()` 支持通过 `VIDEO_PARSER_REQUIRED=true` 将 Video Parser 纳入必需健康判定；未设置时按可选能力处理。
+
+## 版本来源
+
+根目录 `VERSION` 与 `source_clean/VERSION` 当前均为 `0.5.5`。构建脚本会从根目录 `VERSION` 复制到 `source_clean/VERSION` 再构建镜像。
+
+## 验证命令
+
+```bash
+cd /root/cloudsearch_deploy/source_clean
+npm run build
+npm test -- --run src/health/health.test.ts
+curl -fsS http://127.0.0.1:9527/health
+```