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

39 lines
4.0 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 管理员虚拟化工作区
## 页面职责
| 页面 | 职责 |
| --- | --- |
| 资源调度 | 地区、线路、资源池、容量健康与资源预留;摘要卡进入相同条件的列表 |
| 计算节点 | 节点信息、调度容量、公网地址池、VPC 传输和存储配置;仅保留一个 Agent API 快捷入口 |
| Agent API | 各节点的连接身份、密钥和能力测试;普通管理员只读,超级管理员可修改和测试 |
| 云镜像模板 | 不可变版本、导入记录、首次启动脚本、主副本及宿主机副本 |
| 救援镜像 | 救援 ISO 的导入、发布、副本与退役清理 |
| 虚拟机管理 | 实例详情、设置、备份恢复和维护迁移;全局备份库独立于源实例生命周期 |
| 维护通知 | 按计算节点或公网地址池冻结受影响用户,并异步发送维护窗口通知 |
| 实例补偿 | 按单实例、计算节点或公网地址池预览受影响实例,并创建可审计的可用时间补偿批次 |
VPC、对象存储和系统运行与异常任务仍使用现有独立工作区。
## 查找与筛选
- 全局备份库支持 `q`(备份名称)、`user_id`、`instance_id`、`host_id` 和 `state`,条件以 AND 组合;总数与分页使用同一查询。清空条件回到第一页,翻页保留当前条件,替换请求不能覆盖新结果。来源实例或宿主机缺失不影响按账本 ID 查找备份。
- 云镜像模板和救援镜像针对完整目录即时搜索名称、系统/版本及宿主机,状态可选全部、进行中或异常。搜索不修改对象或操作资格;目录刷新保留条件,`catalog_q`、`catalog_status` 写入页面 URL。进行中与异常可以重叠,例如一份正在退役但有清理债务的 ISO。
- 资源摘要的 `ready_pools` 使用资源池的基础就绪状态;`ready_hosts` 使用统计时相同的 Agent、存储、网络、容量和调度判断。CPU/IP 入口选择有对应可用资源的资源池;异常保留进入 `state=uncertain`。页面搜索使用 `resource_q`,异常开关使用 `resource_issues=1`,刷新后仍生效。
## 操作与状态定义
`admin-instance-actions.js` 集中实例操作的安全读取、同步修改、严格 202 任务提交、任务公告、终态解释及锁定提示。配置和备份模块只接收该模块及页面所需回调,迁移继续复用备份的提交互斥。旧 `admin-instance-transport.js` 已删除。
请求安全仍由 `admin-request-runtime.js` 承担;轮询仍由 `task-observer.js` 承担。超时、断网、非法任务回执或效果未知不自动重放,宿主机成功但本地仍在恢复也不视作可继续操作。
云模板导入使用 `CloudTemplateImportStateMachine` 的单一可执行定义判断操作、恢复步骤、转换和清理候选。取消入口与读模型共享未知上传结果的证据限制。`CloudTemplateImportReadModel` 只读取并投影公开字段,不继承导入执行基类或读取对象存储凭据;执行模块复用同一个公开投影。
实例补偿页面只允许具备管理权限的管理员预览和创建;只读管理员仍可查看批次与脱敏收件人。创建必须携带预览返回的受众摘要和幂等键,摘要漂移时拒绝旧请求。同一事故不能重复补偿同一实例;补偿只延长现有服务与权益窗口,不改余额、不增加流量字节,也不创建新的自动备份权益。完整账本、执行和通知边界见 [`SERVICE_COMPENSATION.md`](SERVICE_COMPENSATION.md)。
## 验收
变更需要通过实例动作、导入状态机/分段上传、备份筛选与分页、镜像目录筛选、资源投影、补偿预览与幂等创建、管理员权限、模板编译及静态资源版本测试。浏览器检查应覆盖桌面与手机宽度、空结果、长名称、只读管理员、补偿详情与异常状态,以及刷新后保留筛选条件。
页面精修本身不改变 Agent 协议;实例补偿需要 v35 数据库结构和新版 PHP workers,但无需更新 Agent、网关或编译 AMD64。代码和静态资源必须一起发布,并使用共享资源版本。