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

# VergeOS 版本更新指南

本指南提供将 VergeOS 系统安全更新到新的点版本的最佳实践。它通过循序渐进的方法，重点关注数据安全和系统韧性。

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

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

1. **准备** - 在计划维护窗口之前要执行的步骤
2. **更新前验证** - 在开始更新前立即进行的最终检查
3. **执行更新** - 安装更新的过程
4. **更新后验证** - 确保更新已成功
   {% endhint %}

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

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

## 前提条件

* 对 VergeOS 系统的管理访问权限
* 集群中所有节点的 IPMI 访问权限
* 用于下载更新的网络连接
* **预计时间：** 1-2 小时，具体取决于集群大小和更新复杂度

## 准备阶段

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

### 系统就绪性

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

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

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

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

### 文档与规划

* [ ] 在平台文档中更新计划维护窗口
* [ ] 审查任何可能需要同时执行的协同更新/升级
  * 避免合并不必要的更新
* [ ] 查看版本发布说明，并规划任何特定影响
* [ ] 记录当前系统配置，以便回滚参考
* [ ] 为受影响用户规划沟通时间表

### 资源验证

* [ ] 检查集群资源利用率
  * 确保您的系统有足够的冗余资源，即使失去最大节点也能运行
* [ ] 确认主机之间的网络路径
  * 从每个节点：节点诊断 -> Fabric 配置（所有节点中的所有路径都应为 "confirmed:true"）
* [ ] 如果近期尚未测试网络冗余，请在更新前安排测试
* [ ] 通过一种在紧急情况下允许控制台访问的方法，确认可访问所有主机的 IPMI

### 更新预演

1. 在 VergeOS 中，导航到 **系统 > 更新**
2. 单击 **检查更新**
3. 下载更新（在点击“安装”之前不会开始）
4. 记录当前版本和目标版本以便文档记录

## 更新前验证

请在计划维护当天、开始更新前执行以下检查：

### 当前状态验证

* [ ] 确认当前运行版本为预期版本
* [ ] 检查日志中近期错误
  * 记录任何非关键问题
  * 如果发现关键错误，请取消
* [ ] 验证资源可用性满足 N+1 要求
  * 确认 RAM 使用情况允许在一个节点离线时工作负载继续运行
* [ ] 验证系统快照是最近的且可用
  * 将最近的快照设置为在未来几天后过期，以便额外保留
* [ ] 确认多站点同步功能正常且已更新到最新
* [ ] 验证所有 vSAN 层都处于健康状态（绿色状态）
* [ ] 确认没有节点正在等待重启
* [ ] 记录系统性能基线，以便更新后进行比较

### 更新验证

* [ ] 在以下位置确认您的预演更新 **系统 > 更新**
* [ ] 再次检查更新
  * 如果还有另一个更新，请在继续前仔细评估
* [ ] 验证更新过程有足够的磁盘空间
* [ ] 确认所有节点均可访问且有响应

## 执行阶段

### 安装更新

实际更新过程：

1. 导航到 **系统 > 更新**
2. 单击 **安装** 以开始更新过程
3. **监控节点 1** 因为它会自动：
   * 自动进入维护模式
   * 重启并应用更新
   * 恢复服务
4. **观察后续节点** 因为系统会继续更新并重启各节点
5. **监控工作负载** 并在整个过程中监控系统资源使用情况
6. **跟踪进度** - 每个节点将按顺序更新，以保持服务可用性

{% hint style="success" %}
**更新监控**

在更新过程中，您可以在 系统 > 更新 部分监控进度。每个节点都会显示其当前状态以及在各更新阶段中的进度。
{% endhint %}

{% hint style="warning" %}
**请勿中断**

更新一旦开始，请不要关闭节点或中断更新过程。让每个节点自然完成其更新周期。
{% endhint %}

## 更新后验证

更新完成后，验证系统是否正常运行：

### 版本确认

* [ ] 在以下位置确认预期版本 **系统 > 更新**
  * 验证以下软件包处于预期版本：
    * **osm** （Open Street Maps 数据）
    * **yb** （Verge.io 云软件栈）
    * **yb-help** （集成帮助与文档）
    * **ybos** （Verge.io 操作系统）

### 系统健康检查

* [ ] 确认以下位置中的“Nodes Updated”磁贴： **系统 > 更新** 为绿色且所有节点已完成
* [ ] 确保所有 vSAN 层显示绿色状态
* [ ] 验证所有节点均显示绿色“Running”状态
  * 确认节点没有任何待处理重启
* [ ] 根据您的成功标准按需测试/确认来宾系统
* [ ] 手动创建一个保留数天的快照
* [ ] 检查日志中是否有新的或意外的事件
* [ ] 验证准备步骤中概述的所有成功标准
* [ ] 确认系统性能与基线相当或更好

### 功能测试

* [ ] 测试关键 VM 操作（启动、停止、迁移）
* [ ] 验证网络连通性和性能
* [ ] 确认备份和快照操作正常
* [ ] 测试任何自定义集成或自动化

## 故障排除

### 常见问题

**更新过程在某个节点上停滞**

* 通过 IPMI 检查节点可访问性
* 查看系统日志中的错误消息
* 验证到停滞节点的网络连通性
* 如果节点仍无响应，请联系支持

**更新后版本不匹配**

* 允许额外时间让所有组件同步
* 检查是否有软件包安装失败
* 验证节点之间的网络连接
* 查看更新日志中的具体错误

**更新后性能下降**

* 与更新前基线进行比较
* 检查是否出现新的资源限制
* 查看 vSAN 层的健康状况和性能
* 监控 24-48 小时以建立新的基线

**更新后 VM 无法启动**

* 检查 VM 配置兼容性
* 验证存储层可访问性
* 查看特定于 VM 的日志中的错误
* 逐个测试 VM 操作

## 回滚流程

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

如果出现问题，最安全的方法是暂停、调查异常行为，然后在清楚了解问题后再继续。VergeOS 更新旨在向前兼容，因此回滚并不总是可行。
{% endhint %}

### 如果出现问题

1. **记录问题** 通过截图和日志进行详细记录
2. **识别并隔离问题** - 确定它是影响所有节点还是特定组件
3. **联系支持** 在尝试任何回滚步骤之前
4. **保留系统状态** 以便进行故障排查分析
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-update.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.