> 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/run-the-platform/zh/yun-wei/sop-scale-out.md).

# VergeOS vSAN 横向扩展指南

本指南介绍了通过添加新节点安全横向扩展 VergeOS 系统的最佳实践。它通过一种系统化的方法，重点关注数据安全和系统韧性。

{% hint style="info" %}
**概述**

扩展 VergeOS 系统需要周密的规划和执行，以确保对服务的影响最小。本指南将该过程分为以下主要阶段：

1. **准备** - 在计划维护窗口之前要执行的步骤
2. **横向扩展前验证** - 在开始横向扩展前立即进行的最终检查
3. **横向扩展执行** - 添加新节点的过程
4. **横向扩展后验证** - 确保横向扩展成功
   {% endhint %}

{% hint style="info" %}
**特定环境要求**

本指南涵盖一般最佳实践。您可能需要根据您的具体环境和需求调整这些步骤。
{% endhint %}

## 前提条件

* 对 VergeOS 系统的管理访问权限
* 集群中所有节点的 IPMI 访问权限
* 新节点硬件已正确上架并连接
* 已验证新节点的网络连通性
* 包含适当 VergeOS 安装程序版本的 USB 驱动器
* **预计时间：** 2 到 4 小时，具体取决于数据重建和集群大小

{% hint style="warning" %}
**重要**

请确保您有一个维护窗口，以考虑可能的重建时间。根据数据量和存储性能，vSAN 数据重新分配可能需要数小时。
{% endhint %}

## 准备阶段

请在计划维护窗口之前充分提前完成以下步骤：

### 系统就绪性

* [ ] 确保系统快照保留足够，以便在需要时回滚
* [ ] 为您的工作负载设定明确的成功和验证标准
* [ ] 确定您的特定用例所需的 VM、服务等群组

{% hint style="info" %}
**用例示例**

VDI 可能有多个不同的镜像或资源池。VPS 可能更侧重于网络功能和连通性。
{% endhint %}

* [ ] 梳理任何必须持续运行的对时间敏感的系统和客户机事件

### 硬件准备

* [ ] 确认可访问所有现有主机的 IPMI
  * 通过一种在紧急情况下可能允许访问控制台的方法
* [ ] 将要添加的新节点也纳入此次维护规划
* [ ] 验证 VergeOS 是否为当前受支持的版本
  * VergeOS 正在运行最新版本
* [ ] 已预先准备好包含适当安装程序版本的 USB 驱动器

### 文档与规划

* [ ] 更新平台文档（端口、IP、VLAN 等）
* [ ] 记录当前集群配置，以便作为回滚参考
* [ ] 为受影响用户规划沟通时间表

### 资源验证

* [ ] 检查集群资源利用率
  * 确保您的系统有足够的冗余资源，即使失去最大节点也能运行
* [ ] 确认主机之间的网络路径
  * 在 Node1 上：节点诊断 -> “Fabric Configuration” 对所有现有节点报告 Core1 和 Core2 路径为 “confirmed:true”

## 横向扩展前验证

请在计划维护当天、开始横向扩展之前执行这些检查：

### 当前状态验证

* [ ] 资源可用性 - 系统为 N+1
  * 验证 RAM 使用量足以在有一个节点离线时运行工作负载
* [ ] 系统快照是最新且可用的
  * 将最近的快照设置为在未来几天后过期，以增加保留时间
* [ ] 确认多站点同步功能正常且已更新到最新
* [ ] 验证所有 vSAN 层均处于健康状态
* [ ] 确认没有节点正在等待重启
* [ ] USB 安装程序已插入并被新节点检测到
* [ ] 验证 Node1 的 “Fabric Configuration” 诊断对所有现有节点报告 Core1 和 Core2 路径为 “confirmed:true”

## 执行阶段

### 添加新节点

有关执行 vSAN 横向扩展的详细分步说明，请参阅：

[横向扩展节点安装指南](/plan-and-deploy/zh/shi-shi-zhi-nan/scale-out-nodes.md)

### 关键流程概览

1. **从 USB 安装程序** 启动新节点
2. **配置网络** 在新节点上
3. **将节点加入集群** 通过 VergeOS UI
4. **监控 vSAN 重新分配** - 这是耗时最长的阶段
5. **等待完成** - vSAN 层必须恢复为绿色状态

{% hint style="warning" %}
**关键等待期**

在横向扩展过程中，vSAN 层在重建阶段会显示黄色状态。在继续执行其他任何操作或将横向扩展视为完成之前，务必等待 vSAN 层恢复为“绿色”健康状态。
{% endhint %}

{% hint style="success" %}
**监控进度**

您可以在 VergeOS UI 的 System -> vSAN 下监控 vSAN 重建进度。重建过程将显示完成百分比和预计剩余时间。
{% endhint %}

## 横向扩展后验证

横向扩展完成后，请验证系统运行正常：

### 系统健康检查

* [ ] 确认新节点出现在 VergeOS WebUI 中
  * 日志中没有该节点特定的警告
* [ ] 验证 vSAN 修复已完成且所有层均显示绿色状态
* [ ] 根据您的成功标准按需测试/确认来宾系统
* [ ] 检查日志中是否有新的或意外的事件
* [ ] 验证准备步骤中概述的所有成功标准
* [ ] 确认集群资源分布均衡
* [ ] 测试 VM 向新节点的迁移及从新节点迁移

### 性能验证

* [ ] 在横向扩展后监控系统性能 24 到 48 小时
* [ ] 验证存储性能是否符合预期
* [ ] 确认到新节点的网络吞吐量处于最佳状态

## 故障排除

### 常见问题

**vSAN 层在较长时间后仍保持黄色**

* 检查节点之间的网络连通性
* 在 System -> vSAN 中验证存储层健康状况
* 确保节点之间有足够的带宽
* 如果重建在超出预期的时间内仍未停止，请联系支持

**新节点未出现在 WebUI 中**

* 验证网络配置和连通性
* 检查 DHCP/静态 IP 分配
* 确认 USB 安装程序版本与集群版本匹配
* 查看节点安装日志

**重建期间性能下降**

* 这在 vSAN 重新分配期间是正常的
* 考虑安排在低负载时段进行
* 必要时监控并调整工作负载

**网络结构问题**

* 验证 Core1 和 Core2 网络路径
* 检查物理网络连接
* 确认 VLAN 配置与现有节点一致

## 回滚流程

{% hint style="warning" %}
**回滚注意事项**

如果发生问题，最安全的方法是暂停、调查异常行为，然后在清楚了解问题后再继续。完全移除节点可能需要进行 vSAN 数据重新分配。
{% endhint %}

### 如果需要回滚

1. **停止安装** 如果仍在进行中
2. **关闭新节点电源** 以防止数据损坏
3. **让 vSAN 稳定下来** 如果数据已部分迁移
4. **从集群中移除节点** 如果已成功添加，则通过 VergeOS UI
5. **监控系统稳定性** 然后再重新安排横向扩展

## 下一步

在横向扩展成功完成后：

* [ ] 更新监控系统以包含新节点
* [ ] 使用新节点详细信息更新文档
* [ ] 为新节点安排例行维护
* [ ] 考虑更新备份和灾难恢复流程，以适应增加的容量
* [ ] 根据增长预测，规划任何额外的横向扩展需求

{% hint style="danger" %}
**紧急支持**

如果您在 VergeOS 横向扩展中遇到任何问题，请联系 [我们的支持团队](/overview/zh/support-and-services.md) 以获取即时协助。
{% endhint %}


---

# 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/run-the-platform/zh/yun-wei/sop-scale-out.md?ask=<question>&goal=<endgoal>
```

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