> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/learn-the-platform/zh/mo-kuai-3-an-zhuang/03-adding-nodes.md). # 添加节点 ## 概述 一旦您的双节点控制器集群投入运行，VergeOS 支持三种扩容方式： **横向扩展节点** （向现有 HCI 集群同时添加计算和存储）， **仅存储节点** （专用存储扩展），以及 **仅计算节点** （专用计算扩展）。每种节点类型都采用简化的 USB 安装流程，可自动检测核心 fabric 上的现有系统。 本页涵盖三种节点类型的前置条件、安装步骤和验证流程。 ## 前置条件 在向您的 VergeOS 系统添加任何节点之前，请确保满足以下条件： | 要求 | 详细信息 | | --------------- | ---------------------------------------------------------------------------------------------------------------------- | | **可运行的双节点集群** | 《安装指南》中的主控制器节点和备用控制器节点 [《安装指南》](/learn-the-platform/zh/mo-kuai-3-an-zhuang/02-controller-installation.md) 必须已完全安装且运行正常 | | **网络就绪** | VLAN、物理 NIC 分配以及核心 fabric 布线必须与初始设置期间记录的配置一致 | | **匹配的硬件** | 横向扩展节点和仅存储节点应具备与目标集群中现有节点相同的硬件规格（CPU、存储、NIC、RAM） | | **USB 安装介质** | 与现有集群运行版本相匹配的 VergeOS 安装介质 | | **已在 UI 中创建集群** | 如果首次添加 **新的集群类型** （仅存储或仅计算），请先在 VergeOS UI 中创建该集群 **之前** 启动安装程序 | {% hint style="warning" %} **在安装节点之前创建集群** 如果这是您正在添加的第一个仅存储或仅计算节点，您 **必须** 首先在 VergeOS UI 中创建对应的集群： 1. 导航到 **系统 → 集群** 2. 点击 **新建集群** 3. 使用独立的 **计算** 和 **存储** 开关——这不是单一的二选一选择。对于仅存储集群，启用 **存储** 仅此项（关闭计算），或 **计算** 对于仅计算集群，启用仅此项（关闭存储）。（HCI 集群则同时 *两者* 启用。） 4. 保存集群配置 安装程序无法将节点添加到尚不存在的集群中。 {% endhint %} ## 节点类型对比 了解不同节点类型之间的差异有助于您选择正确的扩容策略： ```mermaid flowchart TD A["需要扩展容量？"] --> B{"哪个资源\n是瓶颈？"} B -->|"计算\n和存储都需要"| C["横向扩展节点\n（HCI 扩展）"] B -->|"仅存储"| D["仅存储节点\n（专用存储）"] B -->|"仅计算"| E["仅计算节点\n（专用计算）"] C --> F["安装程序类型：横向扩展\nvSAN：是\n运行虚拟机：是"] D --> G["安装程序类型：横向扩展\nvSAN：是\n运行虚拟机：否"] E --> H["安装程序类型：仅计算\nvSAN：否\n运行虚拟机：是"] style C fill:#e3f2fd,stroke:#1565c0 style D fill:#e8f5e9,stroke:#2e7d32 style E fill:#fff3e0,stroke:#e65100 ``` | 功能 | 横向扩展 | 仅存储 | 仅计算 | | ------------- | -------------- | ------------- | -------------------------------------- | | **安装程序选择** | "横向扩展" | "横向扩展" | "仅计算" | | **vSAN 参与情况** | 是——磁盘添加到现有层级 | 是——磁盘添加到现有层级 | 否——安装时不配置本地存储（通过 PXE 启动的仅计算节点不需要本地启动盘） | | **运行虚拟机工作负载** | 是 | 否 | 是 | | **需要预先创建集群** | 否（加入现有 HCI 集群） | 是（如果是第一个存储节点） | 是（如果是第一个计算节点） | | **典型用例** | 平衡的 HCI 增长 | UCI 存储扩展 | GPU/ML/VDI 计算扩展 | ## 横向扩展节点安装 横向扩展节点是扩展 HCI 集群最简单的方式。它们使用与现有控制器节点相同的硬件，按比例同时增加计算和存储容量。 ### 安装步骤 1. **从 VergeOS USB 安装程序启动** * 将 USB 安装介质插入指定为横向扩展节点的服务器 * 重启，并在 BIOS/UEFI 启动菜单中选择 USB 驱动器作为启动设备 2. **选择节点类型 → “横向扩展”** * 当安装程序显示节点类型菜单时，选择 **横向扩展** * 这表示安装程序将加入一个同时具备计算和存储角色的现有集群 3. **输入管理员凭据** * 提供在主控制器安装期间创建的管理员用户名和密码 * 这些凭据用于将新节点对现有系统进行身份验证 4. **网络自动检测** * 安装程序通过监听来自现有节点的 UDP 数据包来自动检测核心 fabric 配置 * 验证检测到的 NIC 与您记录的布线映射一致 > **提示：** 安装程序可能会提示您识别用于以下网络的 NIC： **外部** 网络，如果无法自动检测。请准备好您的 NIC 到端口映射文档。 5. **集群选择** （如果存在多个集群） * 如果您的系统中有多个集群，安装程序会提示您选择该节点应加入哪个集群 * 在目标集群中选择与此新节点硬件最相似的节点 6. **vSAN 磁盘配置** * 安装程序会显示检测到的磁盘及其建议的层级分配 * 确认存储层级与现有集群配置一致—— **一致性至关重要** * 检查并最终确认磁盘选择 7. **完成安装** * 安装程序会格式化驱动器、安装 VergeOS 并将节点集成到集群中 * 安装完成后节点会自动重启 * 在提示时移除 USB 安装介质 8. **在 UI 中验证** * 登录 VergeOS Web UI * 导航到 **基础架构 → 节点** 并确认新节点显示为运行正常状态 * 查看 **系统 → vSAN** 以确认新磁盘已集成且层级状态正常 {% hint style="info" %} 节点加入后，vSAN 将重新分配数据以纳入新磁盘。在重建阶段，层级状态可能显示 **黄色** 在重建阶段——这是正常的。请等待所有层级恢复为 **绿色** ，然后再添加另一个节点或执行维护。 {% endhint %} ## 仅存储节点安装 仅存储节点可在不增加计算资源的情况下扩展 vSAN 容量。它们用于存储和计算独立扩展的 UCI（统一计算基础设施）架构中。 ### 安装前：创建存储集群 如果这是您的 **第一个** 仅存储节点，请在 UI 中创建存储集群： 1. 导航到 **系统 → 集群** 2. 点击 **新建集群** 3. 启用 **存储** 开关并保持 **计算** 关闭 4. 保存配置 ### 安装步骤 仅存储节点安装使用 **相同的“横向扩展”安装选项** 与常规横向扩展节点相同。关键区别在于该节点加入的是仅存储集群而不是 HCI 集群。 1. **从 USB 安装程序启动** ——与横向扩展相同 2. **选择节点类型 → “横向扩展”** ——安装程序对 HCI 和仅存储节点都使用“横向扩展” 3. **输入管理员凭据** ——对现有系统进行身份验证 4. **网络自动检测** ——验证 NIC 分配 5. **集群选择** ——选择 **存储集群** 您在 UI 中创建的；选择与此新节点最相似的节点 6. **vSAN 磁盘配置** ——确认层级分配与存储集群的预期配置一致 7. **完成安装** ——驱动器被格式化、安装 VergeOS，随后节点重启 8. **在 UI 中验证** ——确认该节点出现在 Nodes 页面上的正确存储集群下 {% hint style="success" %} 由于仅存储节点使用“横向扩展”安装选项，因此区别在于 **您选择的集群** 在第 5 步中。集群类型（仅存储）决定了节点在系统中的角色。 {% endhint %} ## 仅计算节点安装 仅计算节点可提供额外的 CPU、RAM，并可选提供 GPU 资源，而不参与 vSAN 存储。它们非常适合需要高处理能力的工作负载——机器学习、渲染、VDI 或数据分析。 ### 安装前：创建计算集群 如果这是您的 **第一个** 仅计算节点，请在 UI 中创建计算集群： 1. 导航到 **系统 → 集群** 2. 点击 **新建集群** 3. 启用 **计算** 开关并保持 **存储** 关闭 4. 保存配置 ### 安装步骤 1. **从 USB 安装程序启动** ——与其他节点类型相同 2. **选择节点类型 → “仅计算”** ——这是一个独立的安装选项，区别于“横向扩展” 3. **输入管理员凭据** ——对现有系统进行身份验证 4. **网络自动检测** ——验证 NIC 分配 5. **集群选择** （可选）——如果提示，请选择 **计算集群** 以及与此新节点最相似的节点 6. **完成安装** ——安装程序会配置网络设置并 **在不配置本地存储的情况下安装**。仅计算节点也可以通过 PXE 启动，在这种情况下不需要本地启动盘。节点会自动重启。 7. **在 UI 中验证** ——确认该节点出现在 Nodes 页面上的正确计算集群下 {% hint style="info" %} 仅计算节点没有 **vSAN 磁盘配置步骤**。它们通过核心 fabric 从 HCI 或仅存储集群中的节点访问存储。这是与横向扩展和仅存储安装的关键区别。 {% endhint %} ## 安装顺序最佳实践 在部署多集群系统（UCI 架构）时，请遵循以下推荐顺序： ```mermaid flowchart LR A["1. 控制器节点\n（集群 1）"] --> B["2. 存储节点\n（集群 2）"] B --> C["3. 计算节点\n（集群 3）"] style A fill:#e3f2fd,stroke:#1565c0 style B fill:#e8f5e9,stroke:#2e7d32 style C fill:#fff3e0,stroke:#e65100 ``` 1. **首先安装控制器节点** ——它们构成具有 0 级元数据存储的基础集群 2. **第二步添加存储节点** ——确保在计算节点需要之前，vSAN 存储容量已可用 3. **最后添加计算节点** ——它们可立即通过核心 fabric 访问存储 在任何集群内， **按顺序添加节点** ——请等待每个节点完成安装并在 UI 中显示正常后，再开始下一个节点。这样可避免在每个新节点加入时出现重叠的 vSAN 重新分配/重建操作。 ## 故障排除 如果在任一节点安装过程中出现问题： | 操作 | 命令 | 说明 | | ---------- | ---------------------- | ------------- | | **取消安装程序** | 按 `Esc` | 进入命令提示符 | | **继续安装** | `yb-install` | 从安装程序中断处继续 | | **重新开始** | `yb-install --restart` | 重置并重新开始整个安装过程 | ### 常见问题 **重启后节点未出现在 UI 中：** * 验证网络连接——确保核心 fabric NIC 已正确布线 * 检查 USB 安装程序版本是否与控制器上运行的 VergeOS 版本匹配 * 通过控制台查看节点安装日志 **vSAN 层级长时间保持黄色：** * 在数据重新分配期间这是正常的——请在以下位置监控进度： **系统 → vSAN** * 确保核心 fabric 上各节点之间有足够带宽 * 如果重建停滞时间超过预期，请联系 VergeOS 支持 **安装程序无法自动检测网络：** * 验证核心 fabric 交换机端口配置正确（巨帧、已禁用 STP） * 检查物理布线是否与记录的 NIC 到端口映射一致 * 如果自动检测反复失败，请尝试手动配置网络 **集群选择期间显示“没有可用的集群”：** * 确保在启动安装程序之前已在 UI 中创建目标集群（存储或计算） * 验证集群类型与安装程序节点类型一致 ## 验证检查清单 添加任何节点后，请确认以下内容： * [ ] 节点出现在 **基础架构 → 节点** 页面上，且状态为运行正常 * [ ] 节点显示正确的集群分配 * [ ] 对于横向扩展/存储节点： **系统 → vSAN** 显示所有新磁盘及其正确的层级分配 * [ ] 对于横向扩展/存储节点：vSAN 层级恢复为 **绿色** （正常）状态，在重建完成后 * [ ] 已确认核心 fabric 连通性： **节点诊断 → Fabric 配置** 报告 `已确认：true` 适用于所有路径 * [ ] 系统日志中没有与新节点相关的错误事件 {% hint style="info" %} **VMware 桥接** 来自 VMware？VergeOS 使用一个 USB 安装程序，可自动检测核心 fabric 并使用管理员凭据进行身份验证——控制器、横向扩展、仅存储和仅计算角色都通过菜单选择，VergeOS 侧无需为每台主机进行预配置步骤。 {% endhint %} {% hint style="info" %} **Nutanix 桥接** 来自 Nutanix？VergeOS 没有 CVM——存储服务是集成的操作系统守护进程——而横向扩展、仅存储和仅计算都是一等节点角色，通过安装程序选项和目标集群进行选择；一个 USB 安装程序即可覆盖这三种角色。 {% endhint %} ## 要点总结 | 概念 | 摘要 | | ----------- | -------------------------------- | | **三种节点类型** | 横向扩展（HCI）、仅存储和仅计算——各自承担特定角色 | | **单一安装程序** | 一个 USB 安装介质可通过菜单选择处理所有节点类型 | | **自动检测** | 节点会自动在核心 fabric 上发现系统 | | **集群预创建** | 在添加该类型的第一个节点之前，必须在 UI 中创建存储和计算集群 | | **顺序安装** | 在集群内一次添加一个节点，以避免 vSAN 重新分配/重建重叠 | | **先存储后计算** | 在 UCI 部署中，先添加存储节点，再添加计算节点 | | **vSAN 重建** | 在添加提供存储的节点后，请等待 vSAN 层级恢复为绿色后再继续 | ## 后续步骤 在您的节点已添加并验证后，请继续进行安装后验证，以确认整体系统健康状况： [**安装后验证 →**](/learn-the-platform/zh/mo-kuai-3-an-zhuang/04-post-install-verification.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/learn-the-platform/zh/mo-kuai-3-an-zhuang/03-adding-nodes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.