docs: move ops runtime tracking under docs

This commit is contained in:
Your Name
2026-04-19 02:27:06 +08:00
parent 74dc009c3d
commit ad513211e6
26 changed files with 1604 additions and 283 deletions

View File

@@ -0,0 +1,166 @@
# IMPLEMENTATION_STATUS
更新时间2026-04-19 02:25 CST
## 当前真实状态
阶段判断:
- 海外单脑接管能力:约 `95%`
- 分布式检测真实跑通程度:约 `89%`
- 距离“可稳定上线并放心用后台发起检测”:约 `90%`
当前最重要的新事实:
- 大陆节点接管闭环已完成
- acceptance 主链已完成
- `runtime.pull_tasks` 的环境阻塞已解决
- 大陆检测链已开始真实执行
- 当前剩余问题已收敛为“检测总览统计口径未统一”
## 本轮代码与环境收口
本轮代码变更:
- 提交:`74dc009`
- 主题:`fix: inherit sync env in node agent`
本轮实际变更点:
- `domain-api/deploy/systemd/domain-node-agent.service`
- 增加:
- `EnvironmentFile=-/etc/default/domaincheck-api`
- `domain-api/deploy/multi-region/templates/domaincheck-node-agent.env.example`
- 补齐:
- `runtime.start_detection`
- `runtime.stop_detection`
- `runtime.pull_tasks`
本轮环境动作:
- 已在 `mainland-controller-01` 刷新并重启 `domaincheck-node-agent`
- 已在 `mainland-worker-01` 刷新并重启 `domaincheck-node-agent`
- 已确认两台节点 unit 包含:
- `/etc/default/domaincheck-api`
- `/etc/default/domaincheck-node-agent`
- `SupplementaryGroups=systemd-journal`
## 关键验证证据
关键成功证据:
- `mainland-controller-01` 新运维任务:
- `job_id = 87`
- `action = runtime.pull_tasks`
- `status = success`
- 返回结果:
- `pull_state = success`
- `items_total = 50`
- `summary_text = 待检测任务批次拉取并入库成功`
远端日志证据:
- `mainland-controller-01`
- `job start: id=87 ... action=runtime.pull_tasks`
- `job complete: ... ok=True`
节点运行证据:
- `mainland-controller-01`
- `participation_state = running`
- `items_running = 5`
- `items_total = 200`
- `mainland-worker-01`
- `participation_state = running`
- `items_running = 5`
- `items_total = 70`
## 代码闭环
当前已经被验证打通的链路:
- detect.start 触发远端动作排队
- mainland controller 的 sync-agent / pull_tasks 目标地址读取
- Node Agent 远端执行 `runtime.pull_tasks`
- 大陆 controller 拉批入库
- 大陆 controller / worker 进入执行态
这意味着:
- “点开始检测后大陆节点完全不参与”这个问题已经被修掉
## 外部条件闭环
已经闭合:
- SSH
- node handover
- bootstrap
- register / heartbeat
- acceptance
- journald 权限
- node-agent 同步目标地址继承
当前不再依赖用户补充的外部条件:
- 不需要再补 `SYNC_TARGET_API_BASE_URL`
- 不需要再手工改 controller 的 node-agent env
- 不需要重装系统
## 当前剩余问题
当前唯一剩余问题:
- 控制面“检测总览”口径仍未和大陆拉批执行口径统一
具体表现:
- `ops/nodes`
- 明确显示大陆 controller / worker 正在执行
- 但:
- `/api/v1/detect/queue-summary`
- `/api/v1/detect/job/active`
- 仍主要显示旧的:
- `overseas-control-01`
- `unassigned`
因此当前判断是:
- 执行链路已经通
- 展示与统计口径还没完全通
## 当前是否可以直接上线
当前结论:
- 可以继续做检测功能测试
- 但还不建议宣称“检测总览已经完全可信、可以直接签收上线”
原因不是执行失败,而是:
- 总览统计仍会让人误判“大陆没跑”
## 当前优先级判断
最高优先级:
- 收敛 `detect/queue-summary` / `detect/job/active` 的统计口径
当前不应继续推进:
- 新运维页面
- 控制面增强
- 新模块
- 发布动作
- 与检测总览收口无关的任何功能
## 完成下一轮后的预期
如果检测总览口径收敛成功:
- 后台将能同时看到:
- 海外触发
- 大陆拉批
- 大陆执行
- 统一进度统计
- 整体可上线程度预计提升到 `94%~96%`