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/VALIDATION.md

11 KiB

本版验证记录

2026-10-07:面板资源账本取代宿主机盘点

  • 调度、创建放置和网络选项现在只读取面板配置的容量策略、活动资源池、reservation 账本和 cloud_public_ips;不再要求容量快照、盘点新鲜度、宿主机 host/network-options 或 VM discovery 结果。
  • 创建和换 IP 的引擎路径只读取面板传入的具体地址池参数与持久 claim,并用原子 claim 防并发重复;不会为每个请求枚举宿主机全部虚拟机。
  • 宿主机保存/连接测试只验证 SSH、存储池和网络资源,不调用 list_vms();用户 VM 列表和指定 UUID 的状态读取仍保留为用户操作及结果核对路径,不参与容量或 IP 调度。
  • 用户列表、实时状态和生命周期状态同步只向引擎发送面板已知的 UUID(每批最多 100 个);旧的无参数全量状态接口仅为未接入面板的私有兼容 UI 保留。
  • 引擎本机兼容 UI 仍保留全量 /api/v1/vms、无参数 /api/v1/vm-states 和资源目录接口;它们不进入 PHP 调度链,部署只允许 127.0.0.1:8000,不能作为公网管理入口。inventory-panel 是旧 UI 的通用卡片类,不代表已保留宿主机容量盘点功能。
  • 旧 cloud_instances.spec_json 的可验证资源与公网地址会在地址池物化时迁移到面板账本;缺失、损坏或重复数据会阻止该宿主机调度。管理宿主机 IPv4 需在 reserved_ips 中显式保留。
  • 私有引擎仍负责最终宿主机操作和具体 IP claim。网络超时或响应不确定时保留 operation_id 与 reservation,先核对再决定补偿;同一 client token 重试不得重复创建。
  • 最终隔离回归:engine.tests.test_libvirt_service 183 passed、10 skipped;test_app.py 与 test_engine_boundary.py 205 passed、4 failed。4 个失败均为既有的云模板平台策略断言和 Python 3.9 上传超时/事件循环兼容问题,不涉及面板调度、IP 账本或盘点删除路径。
  • PHP/WASM 契约测试通过:CloudInstanceReadPerformanceTest、CloudInstancePageSsrContractTest、AdminHostNetworkPoolsContractTest、AdminResourceSchedulingContractTest、CloudNetworkIpLedgerContractTest、AdminHostSchedulingContractTest、CloudMultiHostSchemaDefinitionTest、VirtualizationAssetsTest。
  • python -m compileall 与 git diff --check 已通过。当前 macOS 工作区没有 PHP CLI、Composer 依赖、真实 MariaDB、systemd journal 或 libvirt 宿主机;PHP 契约测试使用隔离 WASM 运行时,真实引擎/数据库验收仍需在部署环境复跑。

2026-10-06:系统日志异步读取与详情

  • 系统日志首屏改为只渲染页面框架,列表 API 增加浏览器截止时间、显式停止读取、旧响应隔离和 journalctl 子进程的有界回收;分页游标使用 --cursor + --reverse,按 systemd 的实际 seek 语义从边界向更早记录读取,并防御性移除意外返回的边界记录。
  • 新增管理员只读详情接口,按列表携带的 UTC 微秒时间戳和服务窗口重新读取单条记录,再校验 journal cursor;返回受限的完整诊断字段和完整消息。日志轮转、字段上限和敏感字段省略均有明确状态。
  • 使用工作区捆绑 Node 运行并通过 AdminSystemLogsBehaviorTest.mjs、AdminOperationsCancelBehaviorTest.mjs、日志页 JavaScript 语法检查和 git diff --check。
  • 当前 macOS 工作区没有 PHP CLI、Composer 依赖或 systemd journal,因此 PHP 契约测试、真实 PHP-FPM 子进程超时回收和远程宿主机日志读取仍需在部署环境复跑。

2026-10-06:修复系统日志详情抽屉不可见

  • 现场复现确认:日志行的鼠标点击和键盘事件已经执行,详情请求也可发出;页面没有视觉反馈是因为日志页直接调用 showModal(),绕过了共享抽屉的 is-drawer-visible 动画类,抽屉因此保持在屏幕右侧的初始变换位置。
  • 日志页现在统一使用 VenixDrawerMotion 打开和关闭详情,缺少共享脚本时仍有可见的降级路径,同时锁定页面滚动、恢复触发行焦点,并拦截原生 cancel 事件以完成动画关闭。
  • 详情对话框位于日志 <main> 外,详情消息和字段样式已改为直接以 #system-logs-detail 作用域,避免样式选择器永远不匹配。
  • AdminSystemLogsBehaviorTest.mjs 现通过嵌套消息元素模拟真实冒泡点击,并验证鼠标、Enter、空格、共享 motion、可见类和滚动锁;资产版本更新为 2026100602 以避免部署端继续使用旧脚本。

2026-10-04:盘点只读并发与删除驱动清理(历史记录,盘点方案已退役)

  • host/capacity、host/network-options 与诊断查询已从引擎全局写锁、在线更新修复及 ISO/云镜像惰性清理中拆出;删除后的宿主缓存回收只由持久 tombstone 监督器重试。诊断专项回归:33 passed,覆盖慢盘、取消/晚完成、满接纳窗口终态、淘汰失败上界、异常引用释放及 daemon writer 退出边界。
  • Python 3.12 全量隔离回归:762 passed、10 skipped、68 subtests passed、1 failed。唯一失败仍为 test_app.py::test_native_public_pool_blocks_silent_default_network_change 的既有 409“公网地址池目录存储不可用”;该失败在本轮修改前已有独立复现记录。
  • 本轮没有修改 PHP 或前端源码;当前工作区没有 PHP/Node 可执行文件,因此未重复运行上一节的 PHP/WASM 与页面行为测试。
  • 未连接真实 MariaDB、systemd 或 SSH/libvirt 宿主机。该轮并发盘点验证属于历史实现;当前上线验收应改为并发创建、IP reservation、相同 client token 重试及 operation_id 对账,并验证显式删除模板后的离线宿主重试与代际保护。

2026-10-04:宿主机盘点诊断(历史记录,相关页面和服务已删除)

本轮只增加过渡期诊断历史、管理员页面和跨 PHP/引擎阶段证据;每请求 8 秒预算、容量/IP 提交代际和调度判定不变。该页面和服务不再属于当前部署路径,以下结果仅用于解释迁移前的基线。

  • Python 3.12 全量隔离回归:747 passed、10 skipped、68 subtests passed、1 failed。新增诊断用例覆盖签名/权限、锁等待、存储失败降级、嵌套阶段、取消请求与 worker 晚完成、重启和保留上限。
  • 唯一 Python 失败为 test_app.py::test_native_public_pool_blocks_silent_default_network_change:测试创建公网池返回 409“公网地址池目录存储不可用”,预期 200。在修改前的 fad3b4e 独立源码快照中复现同一失败;未在本轮扩大范围修改。
  • 隔离 PHP 8.5.10/WASM、精确 composer.lock 依赖与 SQLite 测试曾覆盖盘点客户端、诊断、同步服务和关系边界;这些盘点专项名称和结果仅保留作迁移前记录,对应页面、同步服务和诊断服务当前已删除,不再列入本版执行集。
  • 扩展 PHP 检查另发现两项既有失败,均在 fad3b4e 快照复现:CloudProtocolTest.php:85 的源码断言插值 $actor;CloudAdminOperationsServiceTest.php:245 的查询字段断言与原服务选择 payload_cipher 不一致。本轮未修改这两个测试或其既有服务。
  • 过渡期盘点页面行为测试、相关 PHP 语法、两份 JS 语法及 git diff --check 曾通过。该页面和测试已删除;当前前端验收应覆盖宿主机调度抽屉、面板容量计算、IP 账本筛选和操作核对。
  • 未连接真实 MariaDB 或远程宿主机,没有验证生产 PHP-FPM/systemd、cURL 传输、SSH/libvirt 延迟或诊断持久化的实际 I/O 开销;不能据此声称用户当前 unavailable 的根因已确定。真实环境启用后,应依据新增记录验证失败层和最后确认阶段。

2026-09-27:集成基线

2026-09-27,集成代码的隔离验证,不代表生产验收。

  • 当前 macOS 工作区 Python 3.12 回归:515 passed、10 skipped、55 subtests passed。覆盖原虚拟化逻辑及私有 API、签名/重放、多宿主机归属、持久幂等、一次性 VNC、退出后断权、带宽 XML、救援上传摘要,以及到期断网/恢复、同实例变更串行、多网卡 live+config 断网/恢复、退出救援保持计费断网、流量累计检查点和破坏性操作结果核对。生产仍按部署文档使用 Python 3.12 或更新的受支持版本复测。
  • 隔离 PHP 8.5.10 验证源码语法、Smarty 模板、路由目标、精确金额/HMAC、SQLite 购买开通/退款/超时核对/配额/租户隔离、Cookie/Redis 会话撤销及内省、统一用户资源和 noVNC 模块。本次账期与生命周期用例应覆盖提前续费、精确扣款幂等、RX+TX 额度、断网不关机、下期恢复、到期仅断网、3 天宽限期内续费恢复,以及宽限期结束后的实例与受管磁盘删除;当前 macOS 工作区没有 PHP 可执行文件时,需在下方 PHP 8.5 环境命令中复跑。
  • Chrome 使用模拟 API 检查套餐购买、VM 详情/指标/凭据、公钥、重装/救援、后台宿主机/镜像操作与 CSRF;用户账户及登录等页面进行桌面/手机布局检查。不连接真实数据库或宿主机。
  • PHP 隔离环境不提供 sodium:CloudSecretsTest 明确跳过,原 Paytaro/易支付密钥加密测试因同一缺失无法运行;财务/会话测试的加密存储仅用明确标注的测试替身,不作为实际加密验证。生产必须安装 sodium,没有弱加密回退。
  • Python 的跳过项需要真实 libvirt/网络环境。没有验证真实 MariaDB 并发、AlmaLinux systemd、宿主机 VM 操作、SMTP、支付和大文件上传。

在具备依赖的环境复测

不要使用生产数据库/宿主机运行额外真实集成测试;以下默认单元/隔离测试:

cd /home/virt-cloud/web
for test_file in tests/*Test.php; do php "$test_file" || exit $?; done

cd /home/virt-cloud/engine
.venv/bin/python -m pip install -r requirements-dev.txt
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -m pytest -q -p no:cacheprovider

PHP 测试需 Composer 开发可用依赖和测试所用 PDO SQLite。测试中的模拟凭据、地址与密钥不是部署配置。

上线前按 部署说明 完成测试用户的实际购买、首次 SSH 登录、重装、救援、VNC 撤销、故障清理退款与无人登录时持续采样。另须使用短测试账期实际验证:到期只断网、宽限期续费恢复网络、宽限期结束后 VM 定义/系统盘/cloud-init 盘均被删除,以及删除失败或响应丢失时不会错误标记成功。共享公网网桥的 IP/MAC 防欺骗及宿主容量调度尚未提供,不能只凭单元测试开放不受信任客户的资源销售。