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.
virt/docs/GO_AGENT_OPERATION_MATRIX.md

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 运行时 配置和旧服务单元:

  1. 矩阵中所有面板仍暴露的能力均有 Go Agent 实现和真实宿主回读证据;
  2. PHP 每个写路由已经切到 Agent,且没有隐式回退到 Python/SSH;
  3. 新 schema 已在全新数据库上完成初始化、并发/CAS/租约和审计验收;
  4. uncertain 操作可按 operation ID 只读核对,重启恢复和回滚演练通过;
  5. Go、PHP、浏览器和 103/代表性生产宿主验收通过,并保留已签名发布物;
  6. 回滚窗口关闭且得到单独的删除授权。

在这些条件满足前,删除 Python 会把尚未迁移的快照、防火墙、救援、网络和清理 能力变成不可恢复的生产缺口,因此本分支暂不执行删除。