You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
5.2 KiB
5.2 KiB
Go Agent 操作覆盖矩阵
本文只描述 go-agent 绿地协议的当前边界,不是旧 Python API 的兼容清单。
旧数据库字段、旧 operation ID、旧 SSH 参数和旧 seed 不会被 Agent 读取或转换。
| 能力 | Go Agent 当前状态 | 进入生产前的必要证据 |
|---|---|---|
| 健康、能力、EFI/Q35/非 Secure Boot | 已实现 | 真实宿主 domcapabilities 回读、TLS/签名验收 |
域创建预检(domain_preflight) |
已实现只读首版 | 严格 UUID/EFI/x86_64/q35/loader policy;只读 capability、规范 XML/hash(API/journal 仅暴露 hash,XML 原文留在 Agent 内部);不分配存储、不改网络、不 define;不依赖先前 host readiness probe,但仍要求认证/TLS/HMAC、Agent 身份和 durable journal;loader 路径仍待 host-bound 阶段选择 |
域创建规划(domain_create_plan) |
已实现只读首版 | 在 preflight 基础上校验 immutable seed/image 摘要并生成 plan hash;journal 只保留 seed manifest/digest 和 XML hash,不发布 seed、不分配存储、不 define、不改电源/网络;未知响应只重做 capability 观察并核对同一计划身份 |
已发布 seed 创建核验(domain_create_validate) |
已实现只读首版 | 按 UUID 验证 immutable NoCloud artifact、manifest/hash 和 pre-host XML,再只读回读宿主能力;seed 缺失/篡改 definitive,能力/文件传输不可用 uncertain;不写 seed、不分配存储、不 define、不改电源/网络,reconcile 先 seed 后 capability |
Host-bound 创建/挂载输入核验(domaincreateattach 内部契约) |
已实现只读内部边界,尚未开放 HTTP operation | 消费未来 Agent resolver 提供的 loader/卷路径前置条件,并验证 immutable seed、路径规范和 storage allowlist;当前不证明 capability freshness、卷所有权/generation 或 openat/TOCTOU;不制作 CIDATA、不分配卷、不 attach/define、不改网络;待 resolver、fd 门控、libvirt read-back 和清理 executor 完成后再开放 API |
| 域 XML 读取 | 已实现只读 | 只返回受限的 UUID/revision/XML hash 摘要;不接受原始 XML,不执行 define |
域观测(XML 摘要 + 电源状态,domain_observe) |
已实现只读 | 按显式 UUID 回读受约束 XML 和 domstate;仅返回 XML hash、状态和时间,不写域/磁盘/网络;未知结果只读 reconcile |
原始域 XML 定义(domain_define) |
已禁用 | HTTP 白名单已移除;待 typed executor 提供 ownership marker、卷/seed identity、原子 inactive define、精确 read-back 和 fenced cleanup 后再设计新 operation |
| 电源 start/shutdown/destroy/reboot/suspend/resume | 已实现首版 | 固定 argv、动作后状态回读;未知结果只读 reconcile,reboot 不以 running 单态确认 |
| NoCloud seed 与云镜像首次启动脚本 | 已实现 artifact 首版 | 目录 manifest/hash、CIDATA 消费链、guest 一次性 marker 验收 |
| Seed media identity resolver(内部) | 已实现只读首版 | 只按 artifact UUID 校验 immutable 目录、manifest 和一次性脚本摘要;结果明确标记为 nocloud-directory/不可 attach,不生成 ISO、不调用 libvirt、不改盘或网络 |
| 完整 VM 创建/磁盘/镜像绑定 | 未实现(define 已有 file-backed 路径 allowlist gate) | 存储池/卷 CAS、磁盘 owner、定义与清理证据;VIRT_CLOUD_AGENT_STORAGE_ROOTS 的全祖先 owner/TOCTOU 验收 |
| 重装、救援、退出救援 | 未实现 | pre/post commit boundary、旧卷/新卷清理清单、QGA/电源回读 |
| 快照创建/恢复/删除 | 未实现 | libvirt job 状态、卷身份、冻结/解冻和取消后的恢复证据 |
| 防火墙规则 | 未实现 | nft/firewalld owner marker、revision/digest、只读 live 规则回读 |
| 网络挂载/服务暂停恢复 | 未实现 | 新网络架构的宿主数据面方案、跨宿主验收;本阶段不写 WireGuard/L3 |
| 删除与失败清理 | Agent 仅实现 inactive 域 undefine 读回边界;PHP 完整删除尚未映射 |
删除 commit boundary、cleanup manifest、磁盘/seed/网络/账务清理和未知结果禁止重放 |
| 控制台票据 / WebSocket | 未实现 | 短期票据、域身份绑定、TLS/WSS 和撤销测试 |
| 宿主扫描/保存/SSH | 不属于 Agent 运行时 | 改为 enrollment + mTLS + capability probe;切换完成后删除旧 SSH 路径 |
删除 Python 的门槛
只有以下条件全部满足,才允许在独立提交中删除旧 Python Engine、旧 SSH 运行时 配置和旧服务单元:
- 矩阵中所有面板仍暴露的能力均有 Go Agent 实现和真实宿主回读证据;
- PHP 每个写路由已经切到 Agent,且没有隐式回退到 Python/SSH;
- 新 schema 已在全新数据库上完成初始化、并发/CAS/租约和审计验收;
uncertain操作可按 operation ID 只读核对,重启恢复和回滚演练通过;- Go、PHP、浏览器和 103/代表性生产宿主验收通过,并保留已签名发布物;
- 回滚窗口关闭且得到单独的删除授权。
在这些条件满足前,删除 Python 会把尚未迁移的快照、防火墙、救援、网络和清理 能力变成不可恢复的生产缺口,因此本分支暂不执行删除。