docs: 固化 TaskTree 部署态 smoke 入口

This commit is contained in:
Codex
2026-07-17 02:55:14 +02:00
parent 0c24cd32a8
commit 3ad0c6ffe9
+12
View File
@@ -104,6 +104,18 @@ tasktree workflow start
- 同一 dispatcher DTO 携带内容进入 API
- API Pod 不挂载调用端文件系统。
- 线上模式要求 `HWLAB_TASKTREE_API_URL` 或显式 `--api-url`,并在原命令末尾增加 `--overapi`
- 部署态 `--overapi` 验收遵循以下入口判定:
- 选定 node 后只读取 `config/hwlab-node-lanes.yaml#lanes.<lane>.targets.<node>` 的 target 级入口;
- 禁止回退到 lane template 的默认 IP 或其他 node 的 URL
- 公网 Cloud API 需要 HWLAB session 时,裸 CLI 的未认证响应不能判定 TaskTree API Pod 故障;
- 直连 smoke 在已部署 API Pod 内执行该 Pod 自带的同版本仓库 CLI,并把 `--api-url` 指向 localhost API
- repo root、Deployment、container 和 port 必须从当前 runtime spec、Pod 启动合同与 owning YAML 解析,不写死一次性路径;
- 输出只保留 operation、HTTP status、group id 和 task/subtask/report/milestone 计数,不回显报告正文。
- Temporal 部署态 smoke 使用临时 TaskGroup 与 Task
- 通过同一 `--overapi` 入口创建;
- 启动 workflow 并确认 run id、完成状态与 report id
- 使用 shell trap 或等价 finally 在成功或失败时删除临时 TaskGroup;
- 禁止为 smoke 改写正式导入组的任务状态或报告计数。
## 自动交付