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.
20 KiB
20 KiB
本版验证记录
2026-10-08:租户 VPC 创建策略、账户配额与幂等加固
- 租户创建 API 现在只接收
name、region_id和request_key;CIDR、前缀、首个 子网、成员容量和 Fabric 身份全部改为平台策略。新 VPC 固定自动分配独立/24,首个 子网覆盖该/24,成员上限为 200;历史大 VPC 的 4096 协议/观测上界不变。 - 默认每账户最多保留 5 个非
deletedVPC,可用cloud_max_vpcs_per_account在 1 至 100 内调整。创建事务先锁账户行,再核对根、配额、 Region/Fabric 和 CIDR 分配;deleting根仍占账户配额,deleting成员仍占成员容量, 只有精确收敛为deleted才释放。 - 同一创建键的回放先于当前配额、Region/Fabric 状态和分配器策略;请求摘要只包含稳定的 名称与地区。历史创建摘要继续按确定性 root、owner/name/region、operation 和 allocator 链接兼容,但缺 operation、network/subnet 或精确 CIDR claim 闭集时 fail-closed。已删除 root 只返回原 tombstone,不复活 CIDR;released allocation 出现残留 claim 同样拒绝回放。
- CIDR 分配、root、首个 subnet 和 operation 位于同一默认数据库事务。删除了失败后的
二次
release()补偿,避免事务回滚后与同 request key 重试竞态、误释放胜者 CIDR。 租户创建表单同步移除高级网络字段并提升资产版本,旧缓存不会继续提交已禁字段。 - PHP 8.5/WASM + SQLite 下
CloudVpcCreatePolicyTest、CloudVpcControlPlaneContractTest、CloudPrivateCidrAllocatorTest、CloudVpcMemberReuseTest、CloudVpcRootDeletionTest、CloudVpcTombstoneConvergenceTest、CloudVpcUserPageContractTest和VirtualizationConfigTest通过;覆盖强制 post-allocation 失败零泄漏、满配额回放、历史 hash、平台状态变化、deleted tombstone、live/released claim 损坏和 deleting 容量。 另通过 105 个 Smarty 模板编译、274 条路由目标、52 个前端资产契约、schema 契约、 修改 PHP 语法、vpc.jsNode 语法和git diff --check。 - SQLite 不实现 MariaDB 的
SELECT ... FOR UPDATE并发语义;上线前仍须在隔离 MariaDB 上并发争抢账户最后一个名额、并发同 key 丢响应重试,并核对最终仅有一条 root、network、 claim 和 create operation。当前未连接真实数据库、PHP-FPM、浏览器或宿主机,也未改变 WireGuard/libvirt/firewalld 数据面。额外全仓SourceSyntaxTest仍被未修改的AdminSystemLogsContractTest.php:108既有解析错误阻断,不归因于本轮 VPC 修改。
2026-10-08:VPC 来宾网络启动代次门禁
- 私网 MAC、
/32地址和唯一的 VPC CIDR scope-link 路由共同生成独立 guest-network generation;成员、自定义 route、ACL/Fabric 等纯宿主变化不改变该 generation。 - 运行中 VM 的新来宾网络不改写 NoCloud seed、inactive XML 或 live device;完全停机
后由 reconcile 写入 seed 与持久 XML,再启动消费。在完成 stop/reconcile/start 且
live metadata 匹配之前,宿主保持
applying/pending_restart,PHP 拒绝将缺失restart_required=false的证据视为 active/usable。 - 相同私网目标重试返回原 seed 字节,不重复轮换 NoCloud
instance-id;写入 后会在 libvirt define 前重新下载 seed 并核对 MAC/IP/routes;缺少安全 boot 网络策略 的旧 seed 明确要求迁移,不通过新 instance-id 重放 credentials。 - current generation 还要通过 QGA 地址、link 与 route 的精确回读;保留地址/路由但
NO-CARRIER/linkdown的接口不能通过。显式 link-down suspension 单独由 XML/config 证明隔离,恢复 link-up 后才重新要求 QGA usable 证据。 evidence_version=2使历史 XML-only succeeded 证据失效;宿主 config proof、每成员 guest readiness 与 VPC 聚合健康分别收敛,tombstone 不再被无关成员的 QGA 状态阻塞。- 本地验证:Python compileall 通过;cloud-init、VPC 数据面、libvirt、协调器及删除回执
的定向回归 394 passed。完整 engine 回归为 1071 passed、10 skipped、8
failed;8 个失败已在本轮修改前的
6dc0d21干净快照复现,属于既有云模板 spec、 重装错误 envelope、Python 3.9 upload timeout/event-loop 与退役宿主盘点式公网池 fixture。 - 隔离 PHP 8.5.10/WASM 下 5 个 VPC 契约/收敛测试全部通过,10 个修改 PHP 文件语法、
vpc.jsNode 语法和git diff --check通过。当前宿主没有原生 PHP CLI;真实 libvirt/cloud-init 验收仍需在测试 VM 内核对地址、唯一 VPC CIDR scope-link 路由与跨 VM 连通性。宿主策略路由、代理 ARP 和 WireGuard AllowedIPs 仍必须保持精确/32。
2026-10-08:根 VPC 可恢复删除状态机
- 租户 API 新增根 VPC 删除:精确名称确认后,PHP 在事务中把根和子资源固定为
deleting,签署空 desired target、待清宿主机闭集及retiring_members身份清单。 普通变更不能覆盖该 revision;失败或响应丢失只能用原 operation/revision/digest 显式核对。 - 引擎在任何 SSH/libvirt 变更前持久化删除 marker,逐成员核对并移除持久化
private0、私网 metadata 与 cloud-init seed,再清理宿主机 VPC 数据面。部分宿主机 已确认时,重试只联系尚无精确不存在性证明的宿主机;完整 receipt 必须先持久化, 随后才能清理引擎 desired 记录。终态 receipt 只保留重放所需的操作身份、摘要、 宿主机闭集和时间戳,不永久保存成员 UUID、私网 IP 或 MAC;旧格式会自动压缩。 - PHP finalizer 严格核对 payload、receipt、历史/待清宿主机集合和子账本,然后验证 CIDR interval 与全部 /24 claim,最后用 revision CAS 释放地址。live allocation 的 幂等重放也会重新证明 claim 闭集;畸形 VPC 核心/子表、残留 claim 或未完成根删除 均会阻止账户删除。只有完成删除的子账本会被清理,以释放全局 member 唯一键;根、 宿主机和 operation 保留为审计 tombstone。
- 前端只有详情接口明确返回
state=deleted才结束删除提示;分页列表缺失或 404 不会被 当作成功。deleting期间锁定所有普通编辑,仅保留“核对 / 重试”。 - 直接相关 Python 模块回归:429 passed、56 subtests passed;覆盖 VPC 协调器、
数据面脚本、内部 API 和 libvirt 持久 XML/metadata/seed 清理。完整 engine 回归为
1007 passed、10 skipped、80 subtests passed、5 failed;5 个失败在未修改的
7f9fb9c干净快照逐项复现,分别属于既有云模板 spec、重装错误结构和公网 IP 池 fixture,不是本次删除状态机引入。 - 隔离 PHP 8.5/WASM 下
CloudVpcRootDeletionTest、CloudPrivateCidrAllocatorTest、CloudVpcControlPlaneContractTest、CloudVpcUserPageContractTest、ManualAccountDeletionSqliteTest和ManualAccountDeletionTest全部通过;本轮 11 个 PHP 文件语法、274 条路由目标、vpc.jsNode 语法、Pythoncompileall与git diff --check通过。 - 当前没有连接真实 MariaDB、SSH/libvirt、nft、NetworkManager 或 ifupdown 宿主机。 生产验收必须覆盖多宿主机部分失败/重启续跑、HTTP 回执丢失、真实 seed 重写和数据面 移除回读。含私网成员的根删除要求相关 VM 已停机;managed-save 或原生快照存在时会 保留 tombstone 并拒绝继续,处理阻断后再显式 reconcile。
2026-10-07:在线更新后部署页 SQL 回归修复
- 在线更新到
521d40a后,/user/cloud/deploy在读取销售目录时会因cloud_hosts不存在host列而返回 500;同一错误也影响管理员资源汇总。根因已在e7230ff修复,应用查询现在只使用面板资源策略、reservation 和已物化的公网 IP ledger。 - 管理 IPv4、网关和 DNS 必须在地址池
reserved_ips中显式保留;代码不再从宿主机模型读取 SSH/管理地址,也不通过宿主机盘点补全地址。 - saleCatalog SQLite/WASM 首屏 smoke 通过;部署 SSR、资源调度、IP ledger、宿主机网络池/调度、模板编译、虚拟化资产和 Node JS 语法检查通过。完整财务流程继续执行到既有 reconciliation 场景后失败,不能把该失败归因于本次缺失列修复。
- 代码修复提交为
e7230ff,随后补充部署 smoke 与验证记录文档;提交链已推送到远端venix。真实 PHP-FPM、MariaDB、浏览器和宿主机仍需部署验收;上线后应同时检查/user/cloud/deploy、/api/v1/catalog和 PHP-FPM 错误日志。
2026-10-07:移除账户实例数量上限
- 删除账户实例数量配置、购买事务中的账户级 409 检查,以及金融测试中依赖该限制的场景;账户实例数量现在只受销售库存、宿主机面板容量、reservation 和具体公网 IP 账本约束。
- 全仓精确搜索未发现该配置键或账户上限错误文案的 CSS、JS、SQL 残留;
cloud_host_capacity_policies.max_instances保留为单宿主机调度容量,分页大小和快照/防火墙等其他实例上限也未误删。 - 账户上限相关的财务流程已越过,完整金融测试仍在既有 reconciliation fixture 处失败;具体契约、模板、JS 语法和
git diff --check通过。真实 PHP-FPM、MariaDB 和并发购买仍需部署环境验收。
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_service183 passed、10 skipped;test_app.py与test_engine_boundary.py205 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 购买开通/退款/超时核对、宿主机面板容量/IP 账本、租户隔离、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 防欺骗及宿主容量调度尚未提供,不能只凭单元测试开放不受信任客户的资源销售。