添加 SmartX 云平台
云空间管理端通过对接 SmartX 的 API 接口，实现对底层算力资源的纳管。由于 SmartX 平台的资源组织特性，在接入前需先在云平台端完成基础的虚拟机组准备。
一、 前置准备：创建虚拟机组
由于目前管理端尚未支持通过 API 接口调用来动态创建 SmartX 虚拟机组，因此需要管理员在 SmartX 控制台中预先创建好用于存放云桌面的虚拟机组。
-
创建虚拟机组： 在 SmartX 控制台中，点击右上角菜单，选择“创建虚拟机组”。
-
命名规范与过滤机制：
输入虚拟机组名称。核心逻辑说明如下：- 逻辑映射：SmartX 的 虚拟机组 对应云空间中的 项目。
- 安全过滤：为避免将非桌面用途的虚拟机（如管理端、接入网关或其他业务云主机）同步进云空间导致误删风险，系统采用“分组前缀”匹配机制。
- 命名建议：默认约定以 “VDI-” 作为前缀（如
VDI-设计部）。只有匹配该前缀的虚拟机组才会被同步为“项目”。
-
虚拟机组视图核对： 在 SmartX 左下角将“集群层级下展示”切换到“虚拟机组”，即可通过目录树查看已准备好的虚拟机组列表。
-
虚拟机准备（可选）： 您可以预先在这些组内创建虚拟机，同步后将直接作为桌面资源；也可以待项目同步完成后，在云空间桌面池中来创建桌面（推荐方式）。
二、 操作流程
-
进入界面： 登录系统控制台，访问 “资源 -> 云平台”。
-
发起添加： 点击页面左上角的 “添加” 按钮。
-
配置 SmartX 属性： 根据界面提示输入以下参数，完成后点击 “确定”。
- 云平台地址：SmartX 管理节点的 API 访问地址。
- 用户/密码：具备管理权限的账号信息。
- 分组前缀：填写您在 SmartX 中预设的分组前缀特征（默认值为
VDI）。系统将仅纳管匹配此特征的虚拟机组。
三、 核心运维逻辑
-
资源对应关系：
- 对应关系：SmartX 虚拟机组 ↔ 云空间项目 ↔ 桌面池。这三者是一一对应的关系。
- 实例同步：仅处于被纳管项目（匹配前缀的组）中的虚拟机实例，才会被同步到云空间并映射为桌面。
-
层级处理与删除限制：
- 树形结构：系统会将树形结构中所有匹配前缀的“树杈（组）”纳管为项目，但仅同步该层级直接包含的“树叶（虚拟机）”。
- 删除保护：若某个虚拟机组下仍存在子组，系统将禁止在云空间中移出该项目。为简化管理，建议尽量避免使用多层分组结构，建议将所有用于 的分组平铺为同一层级。
-
安全隔离建议： 在部署管理端和接入网关时，请务必将这些管理虚拟机存放在不带 VDI 前缀的独立虚拟机组中，以防被同步进云空间系统造成误操作风险。
注：上述“分组前缀”的设计逻辑同样适用于 WxStack 和 ZStack 云平台。
注意：关于云平台添加后的自动同步机制、进度监控及异常排查，请统一参考 云平台概述 -> 三、 资源同步与管理机制 章节。