> 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).

# 添加节点

了解如何使用 USB 安装程序向集群中添加横向扩展、仅存储和仅计算节点，从而扩展 VergeOS 系统。

## 概述

当你的双节点控制器集群投入运行后，VergeOS 支持三种扩容方式： **横向扩展节点** （为现有 HCI 集群同时增加计算和存储）， **仅存储节点** （专用于存储扩容），以及 **仅计算节点** （专用于计算扩容）。每种节点类型都采用简化的 USB 安装器流程，可自动检测核心交换网络中的现有系统。

本页涵盖三种节点类型的前置条件、安装步骤和验证流程。

## 前置条件

在向 VergeOS 系统添加任何节点之前，请确保满足以下条件：

| 要求             | 详情                                                                                                                                       |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **正常运行的双节点集群** | 来自以下内容的主控制器节点和备控制器节点： [安装指南](https://docs.verge.io/learn-the-platform/zh/mo-kuai-3-an-zhuang/02-controller-installation.md) 必须已完整安装且运行正常 |
| **网络就绪**       | VLAN、物理网卡分配和核心交换网络布线必须与初始设置时记录的配置一致                                                                                                      |
| **匹配的硬件**      | 横向扩展节点和仅存储节点应在硬件规格（CPU、存储、网卡、RAM）上与目标集群中的现有节点完全一致。若要添加不同的硬件，例如更新一代的服务器，请在同一系统中创建新的集群。                                                    |
| **USB 安装器**    | 与现有集群所运行版本相匹配的 VergeOS 安装介质                                                                                                              |
| **在 UI 中创建集群** | 如果首次添加 **新的集群类型** （仅存储或仅计算），请先在 VergeOS UI 中创建该集群 **在** 启动安装器之前                                                                          |

{% hint style="info" %}
**系统 vs. 集群**

在 VergeOS 中，集群是具有相同硬件特征的一组节点。一个 VergeOS 系统可以包含多个集群，每个集群都可针对不同的工作负载或硬件配置文件进行优化。这与某些 HCI 平台不同，在那些平台中，“集群”指的是整个环境。更多详情请参见 [集群概览](https://docs.verge.io/run-the-platform/zh/xi-tong-guan-li/clusters-overview.md).
{% endhint %}

{% 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 数据包自动检测核心交换网络配置

   * 验证检测到的网卡与您记录的布线映射一致

   > **提示：** 安装器可能会提示你识别用于以下用途的网卡： **外部** 网络，如果无法自动检测。请准备好你的网卡到端口映射文档。
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. **网络自动检测** ——验证网卡分配
5. **集群选择** ——选择 **存储集群** 你在 UI 中创建的；选择与这个新节点最相似的节点
6. **vSAN 磁盘配置** ——确认层级分配与存储集群的预期配置一致
7. **完成安装** ——驱动器被格式化，VergeOS 被安装，节点重启
8. **在 UI 中验证** ——确认该节点在“节点”页面中显示在正确的存储集群下

{% hint style="success" %}
由于仅存储节点使用“横向扩展”安装器选项，因此区分因素是 **你选择的集群** 在第 5 步中。集群类型（仅存储）决定了节点在系统中的角色。
{% endhint %}

## 仅计算节点安装

仅计算节点可提供额外的 CPU、RAM，并可选提供 GPU 资源，但不参与 vSAN 存储。它们非常适合需要高处理能力的工作负载——机器学习、渲染、VDI 或数据分析。

### 安装前：创建计算集群

如果这是你的 **第一个** 仅计算节点，请在 UI 中创建计算集群：

1. 导航到 **系统 → 集群**
2. 点击 **新建集群**
3. 启用 **计算** 切换开关并将 **存储** 关闭
4. 保存配置

### 安装步骤

1. **从 USB 安装器启动** ——与其他节点类型相同
2. **选择节点类型 → “仅计算”** ——这是一个独立的安装器选项，不同于“横向扩展”
3. **输入管理员凭据** ——对现有系统进行身份验证
4. **网络自动检测** ——验证网卡分配
5. **集群选择** （可选）——如果出现提示，请选择 **计算集群** 以及与这个新节点最相似的节点
6. **完成安装** ——安装器会配置网络设置并 **在不配置本地存储的情况下安装**。仅计算节点也可以通过 PXE 启动，在这种情况下不需要本地启动盘。节点会自动重启。
7. **在 UI 中验证** ——确认该节点在“节点”页面中显示在正确的计算集群下

{% hint style="info" %}
仅计算节点没有 **vSAN 磁盘配置步骤**。它们通过核心交换网络访问来自 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. **最后添加计算节点** ——它们可立即通过核心交换网络访问存储

在任何集群中， **按顺序添加节点** ——等待每个节点完成安装并在 UI 中显示为正常后，再开始下一个节点。这样可以避免在每个新节点加入时，vSAN 重新分配/重建操作重叠。

## 故障排除

如果在任何节点安装过程中出现问题：

| 操作         | 命令                     | 说明            |
| ---------- | ---------------------- | ------------- |
| **取消安装器**  | 按 `Esc`                | 进入命令提示符       |
| **恢复安装**   | `yb-install`           | 从安装器中断的地方继续   |
| **从头重新开始** | `yb-install --restart` | 重置并重新开始整个安装过程 |

### 常见问题

**重启后节点未在 UI 中显示：**

* 验证网络连通性——确保核心交换网络的网卡布线正确
* 检查 USB 安装器版本是否与控制器上运行的 VergeOS 版本一致
* 通过控制台查看节点安装日志

**vSAN 层级长时间保持黄色：**

* 这是数据重新分配期间的正常现象——在以下位置监控进度： **系统 → vSAN**
* 确保核心交换网络中的节点之间带宽充足
* 如果重建超过预期时间仍停滞，请联系 VergeOS 支持

**安装器无法自动检测网络：**

* 验证核心交换网络交换机端口配置正确（巨帧、禁用 STP）
* 检查物理布线是否与记录的网卡到端口映射一致
* 如果自动检测反复失败，请尝试手动网络配置

**在集群选择期间显示“无可用集群”：**

* 确保在启动安装器之前已在 UI 中创建目标集群（存储或计算）
* 验证集群类型与安装器节点类型一致

## 验证清单

添加任何节点后，请确认以下内容：

* [ ] 节点显示在 **基础设施 → 节点** 页面中，并处于正常运行状态
* [ ] 节点显示正确的集群分配
* [ ] 对于横向扩展/存储节点： **系统 → vSAN** 显示所有新磁盘及其正确的层级分配
* [ ] 对于横向扩展/存储节点：vSAN 层级恢复为 **绿色** （健康）状态，在重建完成后
* [ ] 核心交换网络连通性已确认： **节点诊断 → 交换网络配置** 报告 `已确认：true` 适用于所有路径
* [ ] 系统日志中没有与新节点相关的错误事件

{% hint style="info" %}
**VMware 过渡说明**

如果你来自 VMware？VergeOS 使用一个 USB 安装器，可自动检测核心交换网络并通过管理员凭据进行身份验证——控制器、横向扩展、仅存储和仅计算角色都通过菜单选择完成，VergeOS 侧无需为每台主机进行预配置。
{% endhint %}

{% hint style="info" %}
**Nutanix 过渡说明**

如果你来自 Nutanix？VergeOS 没有 CVM——存储服务是集成在操作系统中的守护进程——而横向扩展、仅存储和仅计算都是一等节点角色，通过安装器选项和目标集群来选择；一个 USB 安装器即可覆盖这三种类型。
{% endhint %}

## 要点总结

| 概念          | 摘要                                 |
| ----------- | ---------------------------------- |
| **三种节点类型**  | 横向扩展（HCI）、仅存储和仅计算——每种都有特定角色        |
| **单一安装器**   | 一个 USB 安装介质通过菜单选择即可处理所有节点类型        |
| **自动检测**    | 节点会自动在核心交换网络上发现系统                  |
| **集群预创建**   | 在添加该类型的第一个节点之前，必须先在 UI 中创建存储和计算集群  |
| **顺序安装**    | 在一个集群内一次只添加一个节点，以避免 vSAN 重新分配/重建重叠 |
| **先存储后计算**  | 在 UCI 部署中，应先添加存储节点，再添加计算节点         |
| **vSAN 重建** | 在添加会贡献存储的节点后，等待 vSAN 层级恢复为绿色后再继续   |

## 后续步骤

在节点已添加并验证后，请进行安装后验证以确认整个系统的健康状况： [**安装后验证 →**](https://docs.verge.io/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/learn-the-platform/zh/mo-kuai-3-an-zhuang/03-adding-nodes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
