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

35 lines
3.2 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` 只读取并投影公开字段,不继承导入执行基类或读取对象存储凭据;执行模块复用同一个公开投影。
## 验收
变更需要通过实例动作、导入状态机/分段上传、备份筛选与分页、镜像目录筛选、资源投影、管理员权限、模板编译及静态资源版本测试。浏览器检查应覆盖桌面与手机宽度、空结果、长名称、只读管理员,以及刷新后保留筛选条件。
本次优化不改变数据库结构或 PHP/Agent 协议;部署无需更新 Agent、网关或编译 AMD64。代码和静态资源必须一起发布,并使用共享资源版本。