167 lines
3.8 KiB
Markdown
167 lines
3.8 KiB
Markdown
# 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%`
|