docs: define multi-CIDR pool operations

dev
admin 2 months ago
parent 9c84724eb1
commit 59dd1e4d33

@ -166,14 +166,16 @@ location = /engine-console {
## 7. 页面配置与验收
1. 管理员添加宿主机:现有 SSH/root/私钥口令、核验指纹,设置区域、网桥、目录、地址池/网关/DNS/网卡前缀,测试连接。
2. 导入云镜像与救援模板;无已有模板不能开通云镜像 VM。云镜像是面板全局目录,验证后的源文件持久保存在 `runtime/engine/cloud-templates/`;首次在某宿主机创建或重装时才同步一份缓存,之后复用,所以切换地区不会更换或刷新镜像列表。支持 AlmaLinux 8/9/10、Debian 11/12/13、CentOS Stream 9/10、Ubuntu 20.04/22.04/24.04/25.04/25.10/26.04 x86_64 云镜像。官方镜像可填写官方镜像站的 HTTPS 文件地址,引擎只跟随由官方入口返回且通过公网地址安全校验的跳转链;例如 AlmaLinux 8 可使用 `https://repo.almalinux.org/almalinux/8/cloud/x86_64/images/AlmaLinux-8-GenericCloud-latest.x86_64.qcow2`,Debian 12 可使用 `https://cloud.debian.org/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2`,CentOS Stream 9 可使用 `https://cloud.centos.org/centos/9-stream/x86_64/images/CentOS-Stream-GenericCloud-9-latest.x86_64.qcow2`,Ubuntu 24.04 可使用 `https://cloud-images.ubuntu.com/releases/noble/release/ubuntu-24.04-server-cloudimg-amd64.img`。自制或修复镜像使用管理员页面的本地 QCOW2 上传入口,并明确选择与内容一致的系统和版本;文件必须是 1 MiB 至 4 GiB 的独立、未加密 QCOW2,不能包含 backing file 或外部 data file,ISO 和 raw 镜像均不接受。面板磁盘需为上传临时文件、全局源镜像及 256 MiB 安全余量预留空间,各宿主机的镜像存储池也需容纳本地缓存。远程导入的 SHA-256 可留空;本地上传始终由面板计算、签名并保存实际摘要。
3. 套餐设置规格、每期价格、账期天数、每期流量额度、库存和已启用宿主机。用户提交部署后先生成 30 分钟有效的开通账单,支付成功才创建实例;实例到期前 7 天再生成续费账单。两种账单均可用余额支付,也可由启用的易支付、Paytaro 或 USDT 渠道生成支付订单。在线支付回调会自动结清对应账单;失效账单的晚到款只保留在账户余额中,不会创建实例或恢复已进入删除流程的实例。
4. 测试用户注册验证码、密码重置、充值、生成开通账单和账单支付,确认未支付时没有引擎任务,支付后只创建一个实例,并收到一次开通成功邮件;再验证到期前 7 天只生成一张续费账单并发送提醒、到期仅断网、宽限期内续费恢复网络,以及到期满 3 天后永久删除实例和系统盘;同时验收任务、VM 控制台、SSH、重装、救援、手动删除与图表。
5. 日志库 `engine_vm_metric_samples` 应在所有用户退出后继续新增,`engine_vm_traffic_totals` 应持续累加 RX/TX 字节;稳定 MAC 用于跨 QEMU/tap 重启衔接计数,首批数据需等待采样间隔。
6. 用测试小额度验收:下载与上传合计达额度后 VM 仍运行但所有网卡断开;下一已付费周期开始后当期用量归零且网卡自动恢复。无下一周期时,实例到期后 VM 保持原电源状态但网络立即停用;3 天宽限期内续费会恢复网络,超过宽限期则永久删除实例和面板管理的系统盘。
先不要启用旧 `web/crontab`,付款扫描/备份任务按保留业务单独核对。真实 MariaDB/KVM/SMTP/支付未在开发环境联调,先验收测试环境。`uncertain` 状态先核对宿主机,不直接改库退款或重复毁盘任务。
1. 管理员添加宿主机:填写现有 SSH/root/私钥口令、从可信控制台核验指纹,并设置地区、`default_network`、存储/ISO/救援目录后测试连接。宿主机基础表单不再写入旧版单 CIDR、网关或 DNS 字段。
2. 在“资源调度”中把宿主机加入一个资源池,并设置容量、安全余量和调度状态。当前每台宿主机只有一个权威资源池成员关系,因此也只有该资源池对应的一条权威线路;一台宿主机挂多条线路、多个 bridge/VLAN 或多个路由表属于后续阶段。
3. 打开宿主机“公网地址池”,为同一个 `default_network` 添加一个或多个互不重叠的实际公网 IPv4 CIDR,分别填写网关、DNS、客户机前缀、保留地址和状态。保存只表示期望配置已提交,引擎确认后仍保持 `pending`;可等待 lifecycle 自动盘点,也可在“资源调度”执行一次手动同步。只有池和网络接入均为 `fresh`、`observed_revision >= desired_revision` 且账本已有可用地址后,调度器才会使用该池。完整顺序和失败/回滚边界见 [单宿主机多公网 IPv4 地址池](MULTI_PUBLIC_IPV4_POOLS.md)。
4. 导入云镜像与救援模板;无已有模板不能开通云镜像 VM。云镜像是面板全局目录,验证后的源文件持久保存在 `runtime/engine/cloud-templates/`;首次在某宿主机创建或重装时才同步一份缓存,之后复用,所以切换地区不会更换或刷新镜像列表。支持 AlmaLinux 8/9/10、Debian 11/12/13、CentOS Stream 9/10、Ubuntu 20.04/22.04/24.04/25.04/25.10/26.04 x86_64 云镜像。官方镜像可填写官方镜像站的 HTTPS 文件地址,引擎只跟随由官方入口返回且通过公网地址安全校验的跳转链;例如 AlmaLinux 8 可使用 `https://repo.almalinux.org/almalinux/8/cloud/x86_64/images/AlmaLinux-8-GenericCloud-latest.x86_64.qcow2`,Debian 12 可使用 `https://cloud.debian.org/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2`,CentOS Stream 9 可使用 `https://cloud.centos.org/centos/9-stream/x86_64/images/CentOS-Stream-GenericCloud-9-latest.x86_64.qcow2`,Ubuntu 24.04 可使用 `https://cloud-images.ubuntu.com/releases/noble/release/ubuntu-24.04-server-cloudimg-amd64.img`。自制或修复镜像使用管理员页面的本地 QCOW2 上传入口,并明确选择与内容一致的系统和版本;文件必须是 1 MiB 至 4 GiB 的独立、未加密 QCOW2,不能包含 backing file 或外部 data file,ISO 和 raw 镜像均不接受。面板磁盘需为上传临时文件、全局源镜像及 256 MiB 安全余量预留空间,各宿主机的镜像存储池也需容纳本地缓存。远程导入的 SHA-256 可留空;本地上传始终由面板计算、签名并保存实际摘要。
5. 套餐设置规格、每期价格、账期天数、每期流量额度和库存,并绑定可销售的资源池。用户提交部署后先生成 30 分钟有效的开通账单,支付成功才创建实例;实例到期前 7 天再生成续费账单。两种账单均可用余额支付,也可由启用的易支付、Paytaro 或 USDT 渠道生成支付订单。在线支付回调会自动结清对应账单;失效账单的晚到款只保留在账户余额中,不会创建实例或恢复已进入删除流程的实例。
6. 测试用户注册验证码、密码重置、充值、生成开通账单和账单支付,确认未支付时没有引擎任务,支付后只创建一个实例,并收到一次开通成功邮件;再验证到期前 7 天只生成一张续费账单并发送提醒、到期仅断网、宽限期内续费恢复网络,以及到期满 3 天后永久删除实例和系统盘;同时验收任务、VM 控制台、SSH、重装、救援、手动删除与图表。
7. 日志库 `engine_vm_metric_samples` 应在所有用户退出后继续新增,`engine_vm_traffic_totals` 应持续累加 RX/TX 字节;稳定 MAC 用于跨 QEMU/tap 重启衔接计数,首批数据需等待采样间隔。
8. 用测试小额度验收:下载与上传合计达额度后 VM 仍运行但所有网卡断开;下一已付费周期开始后当期用量归零且网卡自动恢复。无下一周期时,实例到期后 VM 保持原电源状态但网络立即停用;3 天宽限期内续费会恢复网络,超过宽限期则永久删除实例和面板管理的系统盘。
先不要启用旧 `web/crontab`,付款扫描/备份任务按保留业务单独核对。真实 MariaDB/KVM/SMTP/支付未在开发环境联调,先验收测试环境。公网地址池或破坏性任务进入 `uncertain` 时先读取引擎现状并运行受控盘点,不要盲目重复提交、直接改库退款或重复毁盘任务。
## 8. 从旧版更新

@ -2,22 +2,30 @@
## 范围
生命周期进程现在会分批巡检启用的宿主机。每台宿主机的一次完整观测同时读取:
生命周期进程会分批巡检启用的宿主机。每台宿主机的一次完整观测同时读取:
- `GET /internal/v1/hosts/{id}/host/capacity`
- `GET /internal/v1/hosts/{id}/host/network-options`
两个响应均通过严格校验并在同一数据库事务提交后,才算一次成功。巡检不修改管理员资源页面、商品目录或订单调度策略。
两个响应均通过严格校验并在同一数据库事务提交后,才算一次成功。网络响应可以包含同一宿主机的多个公网 IPv4 池;每个池都必须绑定宿主机当前的 `default_network`,且所有池归属该宿主机当前唯一权威资源池对应的线路。巡检不修改管理员资源页面、商品目录或订单调度策略。
## 成功写入
- `cloud_host_capacity_snapshots` 更新 CPU、内存、存储原始字节数、实例数和公网 IP 聚合计数。
- `cloud_host_capacity_snapshots` 更新 CPU、内存、存储原始字节数、实例数和所有公网池的聚合计数。
- `cloud_host_network_attachments` 按网络选择器保存线路接入身份,`cloud_public_ip_pools` 按稳定 `pool_key` 保存 CIDR、网关、DNS、客户机前缀、保留地址、状态和 revision;`cloud_public_ips.public_ip_pool_id` 把具体地址绑定到所属池。
- `sync_state` 写为 `fresh`,`observed_at` 使用已校验的引擎观测时间,`last_attempt_at` 使用 PHP 本地时间。
- 引擎返回的具体 `available_ips` 新建或恢复为 `available`;上次仍为 `available`、但本次已不在列表中的地址改为 `disabled`。
- 引擎返回的每池 `available_ips` 新建或恢复为 `available`;上次仍为 `available`、但本次已不在对应池列表中的地址改为 `disabled`。`draining` 或 `disabled` 池不会产生新的可分配地址。
- PHP 本地已有占用或不确定状态优先于引擎的建议列表。`held`、`reserved`、`assigned`、`changing`、`uncertain` 以及其他非空闲状态都不会被巡检覆盖;带 `reservation_id`、`instance_id` 或 `operation_id` 的行也不会被恢复为空闲。
- `cloud_hosts.health_state` 写为 `healthy`,清除固定错误码,并且只有此时更新 `last_seen_at`。
公网池未配置也是有效观测:容量响应必须同时报告 `configured=false` 和零计数,网络响应必须是严格的 `not_configured` 空结构;已有本地占用记录仍保留,仅旧 `available` 会变为 `disabled`。
公网池未配置也是有效观测:容量响应必须同时报告 `configured=false` 和零计数,网络响应必须是严格的 `not_configured` 空结构;已有本地占用记录仍保留,仅旧 `available` 会变为 `disabled`。完整的地址池模型见 [单宿主机多公网 IPv4 地址池](MULTI_PUBLIC_IPV4_POOLS.md)。
## 地址池状态与 revision
- `active`:允许在盘点完成后向新任务分配地址;`draining` 和 `disabled` 均停止新分配,但不会抹掉现有实例、任务或账本身份。
- 管理员每次有效修改递增该池的 `desired_revision`,引擎观测写入 `observed_revision`。写请求成功后仍为 `pending`;只有完整盘点观察到相同或更新 revision,池及其网络接入才可进入 `fresh`。
- 调度器只选择 `active + fresh`、`observed_revision >= desired_revision` 的网络接入、地址池和 `available` 地址。旧观测、失败观测或尚未核对的配置一律 fail closed,不按“最后看见的空闲 IP”继续销售。
- 更新接口使用 `expected_revision` 做比较并交换;管理员页面持有的旧版本不能静默覆盖另一个管理员刚保存的配置。
## 失败语义
@ -36,19 +44,20 @@
## 并发与锁顺序
成功同步按 `cloud_hosts` → `cloud_host_capacity_snapshots` → 当前宿主机 `cloud_public_ips` 加锁。调度器同样先锁 `cloud_hosts`,再锁 `cloud_host_capacity_policies` → snapshot → IP;以宿主机行为共同入口,避免与管理员策略修改形成反向等待。同步不会锁定其他宿主机的 IP 行;跨宿主地址冲突先只读检查,最终仍由全局唯一地址索引阻止竞态插入。
成功同步以 `cloud_hosts` 为宿主机级哨兵,之后依次锁定 `cloud_host_capacity_snapshots` → 资源池成员关系 → `cloud_host_network_attachments` → `cloud_public_ip_pools` → 当前宿主机 `cloud_public_ips`,同组内按主键顺序。调度与管理员配置也先锁宿主机行,再按各自所需的相同相对顺序锁资源策略、快照、网络身份和具体 IP,避免反向等待。同步不会锁定其他宿主机的 IP 行;跨宿主地址冲突先只读检查,最终仍由全局唯一地址索引阻止竞态插入。
## 生命周期与身份
- daemon 单轮最多检查 10 台启用宿主机,只选择到期宿主机;默认同一宿主机至少间隔 30 秒,可用 `cloud_host_inventory_interval_seconds` 配置为 30~300 秒。到期队列优先选择从未检查或 `health_checked_at` 最旧的宿主机,避免固定低 ID 饥饿,并控制顺序引擎请求对生命周期主循环的占用。
- 管理员精确刷新单台宿主机时调用 `CloudHostInventorySyncService::syncOne($hostId)`;它跳过到期窗口,但复用完全相同的 daemon actor、双响应校验、事务和失败标记,不另开宽松路径。
- 管理员保存公网池后不会在写请求内把账本伪装为已同步:配置先保持 `pending`,随后可由上述 daemon 自动盘点,或由“资源调度 → 手动同步”立即触发同一条 `syncOne` 路径。手动同步失败也不会回退或清空最后一次有效容量。
- heartbeat 新增阶段 `host_inventory_sync`,对外错误仅为 `host_inventory_sync_failed` 或 `host_inventory_sync_unconfigured`。
- `CloudDaemonActor` 统一解析已启用的配置超级管理员;宿主库存同步和实例运行状态同步不再各自复制 daemon 权限逻辑。
## 验证资产与边界
- `CloudHostInventorySyncServiceTest.php`:SQLite + Guzzle mock 行为测试,覆盖双端点成功、容量字节精度、IP 状态保留/禁用/恢复、共享 daemon actor、到期过滤、单宿主机精确刷新、无效响应保留最后快照、临时失败状态与原始错误不落库。
- `CloudHostInventorySyncServiceTest.php`:SQLite + Guzzle mock 行为测试,覆盖双端点成功、多池身份与 revision、容量字节精度、IP 状态保留/禁用/恢复、共享 daemon actor、到期过滤、单宿主机精确刷新、无效响应保留最后快照、临时失败状态与原始错误不落库。
- `CloudHostInventorySyncContractTest.php`:无需数据库和引擎的静态边界测试,覆盖生命周期接线、heartbeat、共享 actor、失败不清空和固定诊断码。
- 当前开发机没有 PHP CLI,无法在此环境执行上述 PHP 测试或 `php -l`;部署/CI 的 PHP 8.5 环境仍须实际运行两个测试,并建议连同 `CloudRuntimeHeartbeatTest.php` 回归。
- 部署/CI 的 PHP 8.5 环境必须实际运行上述测试,并连同 `CloudRuntimeHeartbeatTest.php`、公网池与调度合同测试回归;静态合同通过不替代真实 MariaDB 与宿主网络验收。
上线前必须先运行 `php xcat cloudInit` 创建新增表/列,再重启 lifecycle 进程。真实引擎联调还应验证一个已配置地址池和一个未配置地址池;测试发布不代表生产宿主机已验收。
上线前必须先运行 `php xcat cloudInit` 创建新增表/列,再重启引擎与 lifecycle 进程。真实引擎联调至少应验证同一宿主机的两个不重叠地址池、一个 `draining` 池、一个未配置地址池,以及 revision 冲突和盘点失败;测试发布不代表生产宿主机已验收。当前仍是每台宿主机一个 `default_network` 和一条权威线路,真正的单宿主机多线路属于后续阶段。

@ -1,6 +1,6 @@
# Virt Cloud 集成架构
更新:2026-09-27。替代此前“尚未集成”的计划,描述本版实现边界;真实部署仍需测试环境联调。
更新:2026-10-03。替代此前“尚未集成”的计划,描述本版实现边界;真实部署仍需测试环境联调。
## 请求链路
@ -23,13 +23,15 @@ PHP 是唯一账户入口,所有用户页面使用原虚拟化面板 CSS;后
| 数据 | 权威写入方 | 存储 |
| --- | --- | --- |
| 用户、钱包、套餐、原财务/工单 | PHP | 原业务库表 |
| 宿主机索引、订单、实例、账单、支付映射、账期、续费、公钥、会话、任务 | PHP | `cloud_hosts/orders/instances/invoices/invoice_payments/service_periods/renewals/ssh_keys/sessions/jobs` |
| 宿主机索引、资源池成员关系、网络接入、公网池/IP 账本、订单、实例、账单、支付映射、账期、续费、公钥、会话、任务 | PHP | `cloud_hosts/cloud_host_resource_pool_memberships/cloud_host_network_attachments/cloud_public_ip_pools/cloud_public_ips/cloud_orders/cloud_instances/cloud_invoices/cloud_invoice_payments/cloud_service_periods/cloud_renewals/cloud_ssh_keys/cloud_sessions/cloud_jobs` |
| 宿主机凭据、VM 元数据、镜像、操作进度 | Python | 主库 `engine_records`,敏感记录加密 |
| 引擎签名防重放 | Python | 主库 `engine_request_nonces` |
| 四项性能指标样本 | Python | 日志库 `engine_vm_metric_samples`,保留 30 天 |
| VM RX/TX 持久累计与网卡基线 | Python | 日志库 `engine_vm_traffic_totals`,不随 30 天图表样本清理 |
多个宿主机使用稳定 `host_id`,不共用一个可切换的全局“当前宿主机”。模板、IP 地址池、网关、DNS、虚拟机网卡前缀、磁盘/ISO/救援目录均按宿主机设置。地址池与网卡前缀分开:供应商地址池可以为 /28,虚拟机网卡可以为 /24,不能因此把售卖范围扩大为 /24。
多个宿主机使用稳定 `host_id`,不共用一个可切换的全局“当前宿主机”。模板、磁盘/ISO/救援目录和默认网络均按宿主机设置;单台宿主机可在同一个 `default_network` 下保存多个互不重叠的公网 IPv4 CIDR。每个池有稳定 `pool_key`、独立网关/DNS/客户机前缀/保留地址/运行状态,以及 PHP 期望 revision 与引擎观测 revision。地址池与网卡前缀分开:供应商地址池可以为 /28,虚拟机网卡可以为 /24,不能因此把售卖范围扩大为 /24。具体上线顺序见 [单宿主机多公网 IPv4 地址池](MULTI_PUBLIC_IPV4_POOLS.md)。
当前网络模型有意保持一条权威路径:每台宿主机只有一个 `default_network`,并通过唯一有效的资源池成员关系归属一条线路;多个公网 CIDR 共享该网络接入。线路管理和数据表为未来扩展保留,但“同一宿主机同时销售多条线路”尚未开放。该阶段必须增加多个资源池成员/网络接入选择、bridge/VLAN/路由表验证、逐线路容量以及实例跨接入迁移策略,不能仅给现有公网池补一个线路下拉框。
PHP 不直接解密 Python 记录或执行任意 virsh 命令。主库与日志库可同实例或分别配置地址/端口。敏感业务数据加密;部署数据库连接配置仍是权限受限配置文件,不代表配置文件本身加密。
@ -68,7 +70,7 @@ VNC 凭据 60 秒有效、单次、绑定用户/VM/会话,通过 WebSocket 子
重装、救援、手动删除和到期自动清理使用持久操作编号,进程中断不盲目重复破坏性步骤。自动清理只有在实例定义和受管磁盘的删除结果得到确认后,才把业务库实例标记为已删除;宿主机或磁盘异常会保留失败状态供管理员处理,不会伪装成成功。救援 ISO 为管理员授权原始流上传及摘要校验;线上需配置 FPM/反代超时与大小限制。
尚未实现宿主容量调度、分布式资源预留、IP/MAC 防伪、套餐磁盘 IOPS、备份、热迁移或 HA。线程中断进入待核对,并非完整步骤恢复;后续应增加运维对账与独立执行器。
已实现按资源池的宿主容量快照、CPU/内存/磁盘/IP 预留和多公网池调度;只有容量、网络接入和公网池观测均新鲜时才允许新部署。尚未实现同一宿主机多线路选择、IP/MAC 防伪的完整租户策略、套餐磁盘 IOPS、备份、热迁移或 HA。线程中断进入待核对,并非完整步骤恢复;后续应增加运维对账与独立执行器。
上线前必须验收真实 MariaDB 并发、两库权限、宿主机固件/网桥/SELinux、cloud-init 与 SSH、浏览器 WSS、会话撤销、失败清理/退款。SMTP 沿用 venix,TLS 证书校验已恢复,自签邮件证书需修复信任链。

@ -0,0 +1,55 @@
# 单宿主机多公网 IPv4 地址池
## 当前范围
一台宿主机可以配置最多 32 个互不重叠的实际公网 IPv4 CIDR,每个 CIDR 独立保存网关、1~4 个 DNS、客户机前缀、保留地址和运行状态。当前 CIDR 及客户机前缀范围为 `/24`~`/30`,且客户机前缀不能比地址池 CIDR 更长;具体可售地址由引擎观测和 PHP 账本共同确定,不按 CIDR 文本直接推算后立即销售。
本阶段是“单网络接入、多公网池”,不是“单宿主机、多线路”:
- 每台宿主机仍只有一个 `default_network`(例如 `bridge:br0`)。
- 每台宿主机仍只有一个权威资源池成员关系,对应一条权威线路。
- 该宿主机的全部公网池都必须使用同一个网络选择器并归属这条线路。
真正的多线路需要独立的网络接入、bridge/VLAN/路由表、逐线路容量与实例迁移策略,留到后续阶段实现。
## 权威数据与状态
| 对象 | 作用 |
| --- | --- |
| `cloud_host_network_attachments` | PHP 保存宿主机、线路和 `default_network` 的接入身份 |
| `cloud_public_ip_pools` | PHP 保存每个池的期望配置、`desired_revision`、`observed_revision` 和 `sync_state` |
| `cloud_public_ips` | PHP 商业账本;每个具体地址通过 `public_ip_pool_id` 归属一个池 |
| 引擎公网池目录 | 保存已经应用到该宿主机的 revisioned 运行配置,并提供权威盘点 |
PHP 是订单、预留和具体 IP 状态的权威方;引擎是宿主机运行配置与实际可用地址观测的权威方。两者必须通过盘点收敛,任一方单独“保存成功”都不能证明地址已经可销售。
地址池状态:
- `active`:盘点确认后可用于新部署或换 IP。
- `draining`:停止新分配,保留现有实例和任务身份,用于排空。
- `disabled`:停止新分配;同样不自动删除或释放现有占用。
`pending` 表示期望配置尚未被同 revision 的完整盘点确认;`fresh` 表示 `observed_revision >= desired_revision`;`failed` 表示明确失败或观测缺失;`uncertain` 表示请求结果无法确认。调度器只使用 `active + fresh` 的接入、池和 `available` 地址。
## 部署与配置顺序
1. 更新代码和依赖后,在停写维护窗口运行 `php xcat cloudInit`,再重启引擎、worker 与 lifecycle。
2. 添加宿主机并验证 SSH 指纹,设置地区、目录和唯一 `default_network`。
3. 在“资源调度”把宿主机加入资源池,确认对应线路、容量、安全余量和调度状态。
4. 在“公网地址池”逐个添加实际 CIDR。创建请求使用稳定请求标识避免重复创建;更新携带页面读取到的 `expected_revision`,旧表单会被拒绝而不是覆盖新配置。
5. 保存后池先保持 `pending`。等待 lifecycle 定时盘点,或在“资源调度”执行“手动同步”;两者复用相同的严格双端点校验和数据库事务。
6. 确认容量快照、网络接入和所需公网池均为 `fresh`,revision 已追平,且池下出现 `available` 地址,再开放商品部署。
7. 用测试实例验证创建、重装、同接入换 IP、关机后换 IP、任务失败恢复,以及来自两个不同 CIDR 的实际公网连通性。
旧版 `legacy-default` 只读展示,不在管理页面内自动迁移。本项目当前按全新开发数据运行;如果检测到旧版池,应先停止销售、备份并按新版结构重建,不能把旧池和新版池混合使用。
## 失败、恢复与回滚边界
- 引擎明确拒绝配置时池进入 `failed`;修正输入并基于最新 revision 重新提交。
- 网络超时、5xx、响应不一致或业务库无法确认结果时进入 `uncertain`。先重新读取引擎目录并执行盘点,禁止换一个请求标识盲目重复创建。
- 盘点失败保留最后一次有效容量、占用和具体 IP 行,不写零值,也不把宿主机离线解释为地址已经释放。
- 池中存在实例、预留、换 IP 或不确定任务时,不允许修改 CIDR、网关、DNS、客户机前缀、保留地址或网络接入;只能修改名称与运行状态。
- 停止新销售时先改为 `draining` 或 `disabled` 并完成盘点,不要删除池、复用其中地址或直接改数据库。确认所有占用清空后,再规划后续清理功能。
- 代码回退不等于数据回退:数据库表、PHP revision、引擎目录和 VM 元数据可能已经前进。回滚前备份业务库及引擎密钥/记录;若新配置已写入,优先用前向修复使两端收敛,不要只切回旧代码继续调度。
管理员手动同步不是宽松的“强制刷新”。它与自动盘点使用同一合同;任何一个池计数、revision、网络选择器或地址归属不一致,整次观测都会失败并保留上一次可信状态。

@ -68,7 +68,6 @@ input:focus,select:focus,button:focus-visible{outline:3px solid rgba(18,166,176,
.host-content{max-width:1380px;padding:39px clamp(22px,5vw,76px) 70px;margin:0 auto}.host-heading{display:flex;align-items:flex-end;justify-content:space-between;gap:20px;margin-bottom:29px}.host-heading h1{font-size:29px;letter-spacing:-.6px;margin:8px 0}.host-heading p{color:#8090a0;font-size:13px;line-height:1.6;margin:0}
.host-columns{display:grid;grid-template-columns:minmax(0,1.25fr) minmax(350px,.85fr);gap:19px;align-items:start}.host-side-stack{display:grid;gap:19px}.host-card{background:#fff;border:1px solid #e6edf2;border-radius:13px;padding:26px;box-shadow:0 10px 30px rgba(19,42,65,.027)}.host-card-heading{display:flex;gap:12px;align-items:flex-start;margin-bottom:24px}.host-card-number{display:flex;align-items:center;justify-content:center;flex:none;width:31px;height:31px;background:#e7f8f8;color:#0e919b;border-radius:9px;font-size:13px;font-weight:800}.host-card-heading h2{font-size:17px;margin:2px 0 5px;letter-spacing:-.2px}.host-card-heading p{font-size:11px;color:#91a1b0;margin:0;line-height:1.6}
.host-card textarea{width:100%;min-height:125px;padding:12px 13px;border:1px solid #dce4eb;border-radius:9px;color:#15243a;font:11px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace;resize:vertical;background:#fff}.host-card textarea:focus{border-color:#35b9c0;box-shadow:0 0 0 4px rgba(25,179,187,.1);outline:none}.host-card input[type=file]{height:auto;min-height:43px;padding:9px;font-size:11px}.host-card input[type=file]::file-selector-button{border:0;border-radius:6px;padding:5px 10px;margin-right:9px;background:#e9f6f6;color:#137e89;font-weight:700;cursor:pointer}
.host-public-pool{grid-column:1/-1;border-top:1px solid #e8eef2;padding-top:18px}.host-public-pool-heading{margin-bottom:16px}.host-public-pool-heading strong{display:block;color:#34445a;font-size:13px}.host-public-pool-heading small{display:block;margin-top:6px;color:#8798a7;font-size:10px;line-height:1.6}.host-public-pool textarea{min-height:78px}
.fingerprint-result{margin:18px 0 14px;padding:14px;border:1px solid #b9e6e5;background:#effafa;border-radius:9px}.fingerprint-result>span{display:block;color:#417c85;font-size:11px;font-weight:700;margin-bottom:8px}.fingerprint-result code{display:block;color:#1b5260;font-size:12px;font-weight:800;line-height:1.7;overflow-wrap:anywhere}.host-security-note{font-size:11px;color:#8191a1;line-height:1.75;margin:16px 0 0}.host-security-note code{color:#41566e;font-size:10px;overflow-wrap:anywhere}.host-confirm{margin-top:17px;background:#f0fbf8;border-color:#cce9e0}.host-confirm strong{color:#217d6e}.host-confirm small{color:#659a90}
.host-test-status{font-size:12px;color:#708095;background:#f4f7fa;padding:12px 14px;border-radius:8px;line-height:1.55;margin:0 0 15px}.host-test-status.success{background:#e7f8ef;color:#1d9168}.host-test-status.warning{background:#fff4e6;color:#9a641d}.host-submit-actions{display:flex;gap:9px;flex-wrap:wrap}.host-submit-actions .button{flex:1}.host-card .form-error{margin:0 0 13px}
.update-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:19px;align-items:start}.update-grid .host-card{min-width:0}.update-grid .form-stack input{margin-bottom:17px}.update-grid .form-stack .field-hint{display:block;color:#8395a5;font-size:11px;line-height:1.6;margin:-7px 0 17px}.update-grid .form-stack .button{align-self:flex-start}.update-grid .host-test-status{margin-top:17px;overflow-wrap:anywhere}.update-versions{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:11px}.update-versions>div{border:1px solid #e2ebf0;border-radius:9px;padding:13px;background:#fbfdfd;min-width:0}.update-versions span{display:block;color:#8291a1;font-size:11px;margin-bottom:9px}.update-versions strong{display:block;color:#284459;font-size:12px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;overflow-wrap:anywhere}
@ -179,7 +178,6 @@ tbody tr:hover{background:#fcfefe}
@media(max-width:510px){.create-source-picker,.cloud-fields>.form-grid{grid-template-columns:1fr}}
@media(max-width:510px){.template-catalog{grid-template-columns:repeat(2,minmax(0,1fr));gap:9px}.template-family-selected-mark{top:8px;right:8px;width:20px;height:20px;font-size:11px}.template-family-summary{min-height:140px;padding:13px 8px 10px}.template-family-icon{width:50px;height:50px;font-size:25px}.template-family-footer{min-height:24px}.template-family-selection{max-width:calc(100% - 18px);font-size:10px}.template-versions{padding:8px}.template-version-option{padding:9px 8px}.template-admin-row{grid-template-columns:1fr}.template-admin-row .button{justify-self:start}}
@media(max-width:510px){.workspace-form-body{padding:22px 19px 25px}.workspace-form-actions{padding:15px 19px}.workspace-form-actions .button{flex:1 1 100%}.workspace-form-back{margin-bottom:10px}}
@media(max-width:510px){.host-public-pool>.form-grid{grid-template-columns:1fr}}
@media(max-width:510px){.register-code-row{flex-wrap:wrap}.register-code-row input{flex-basis:100%}.register-code-row .button{width:100%}.pending-user-row{align-items:flex-start;flex-direction:column}.pending-user-row .button{width:100%}.smtp-card .form-grid{grid-template-columns:1fr}}
@media(max-width:510px){.ssh-key-row{align-items:flex-start;flex-direction:column;justify-content:flex-start}.ssh-key-actions{width:100%}.ssh-key-actions .row-button{flex:1}}
@media(max-width:510px){.vm-detail-heading .heading-actions{justify-content:space-between}.vm-detail-heading .heading-actions .button{flex:0 0 auto}.vm-detail-facts{grid-template-columns:1fr}.vm-detail-facts>div{padding:12px 0}.vm-detail-actions .row-button{flex:1 1 135px}.vm-table td{padding:10px 11px}.vm-identity{min-width:0}.vm-name-link{max-width:calc(100vw - 130px)}.vm-settings-navigation{padding-inline:8px}.vm-settings-navigation-button{padding-inline:10px;font-size:11px}.vm-settings-content{padding:24px 17px 28px}.vm-settings-actions .button{width:100%}}

Loading…
Cancel
Save