> 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/knowledge-base/zh/system-administration/updating-vergeos-system.md).

# 更新 VergeOS 系统

## 概述

{% hint style="info" %}
**要点**

* 系统更新应在维护窗口期间执行
* 当资源充足时，更新可实现零停机执行
* 系统更新只从主机系统（顶层父系统）运行
* 租户系统会自动从其主机系统更新
* 更新可以计划执行，也可以按需执行
* 系统会在更新期间自动处理工作负载迁移
  {% endhint %}

本指南提供了在 VergeOS 中执行系统更新的详细说明，无论是按需还是计划执行。

## 前提条件

* 对 VergeOS Cloud Dashboard 的管理员访问权限
* 充足的系统资源，以便在更新期间允许工作负载迁移
* 维护窗口（推荐，但由于具备零停机能力并非必需）

## 执行按需更新

### 1. 检查更新

1. 导航到 **系统** > **更新** 在 Cloud Dashboard 中
2. 点击 **检查更新** 在左侧菜单中
3. 点击 **是** 以确认
   * Packages 部分将显示可用更新
   * 云图标表示可下载的软件包
   * 版本信息会显示当前版本和可用版本

### 2. 下载更新

1. 点击 **下载** 在左侧菜单中
2. 点击 **是** 以确认
3. 等待下载完成

### 3. 安装更新

1. 点击 **安装** 在左侧菜单中
2. 点击 **是** 以确认
3. 等待安装完成
   * 就绪时，状态将显示“空闲 - 需要重启”
   * 重启选项将变为可用

{% hint style="info" %}
不包含 VergeOS 软件包更改的更新不需要完整的节点重启，但仍需使用重启选项来应用更改。
{% endhint %}

### 4. 应用更新

1. 点击 **重新启动** 在左侧菜单中
2. 点击 **是** 以确认
   * 系统将一次处理一个节点：
     * 节点进入维护模式
     * 工作负载迁移到其他节点
     * 应用程序重启/节点重启
     * 节点退出维护模式
   * 进度会显示在状态字段中
   * Nodes Updated 状态会跟踪完成情况

{% hint style="success" %}
使用 **取消重启** 在需要时停止自动重启（例如：用于工作负载重新平衡）
{% endhint %}

## 安排更新

### 1. 创建更新任务

1. 导航到 **系统** > **更新** > **任务**
2. 点击 **新建** 在左侧菜单中

### 2. 配置计划

1. 选择计划选项：
   * **一次性**：保持默认的“Does Not Repeat”
   * **重复**：选择频率（每周、每两周、每月）
2. 设置 **开始日期** 和时间
3. 对于重复任务，可选择设置结束日期

### 3. 配置任务详情

1. 输入必需的 **名称**
2. 添加可选的 **说明**
3. 选择 **任务类型**:
   * 选择“下载、安装并重启”以完成更新
4. 可选：启用 **运行后删除**
5. 点击 **提交** 以保存

## 最佳实践

* 在低使用率时段和维护窗口期间安排更新
* 确保有足够的系统资源用于工作负载迁移
* 在更新过程中监控系统
* 在重大更新前保留常规备份
* 在应用前查看可用更新

## 故障排除

{% hint style="warning" %}
**常见问题**

* **问题：** 工作负载无法迁移
  * **解决方案：** 验证目标节点上是否有足够的资源
* **问题：** 更新过程卡住
  * **解决方案：** 检查系统日志，必要时联系支持
* **问题：** 节点重启后未能重新加入
  * **解决方案：** 查看日志和网络连接
    {% endhint %}

## 反馈

{% hint style="info" %}
**需要帮助吗？**

如果您在更新过程中遇到任何问题或有疑问，请联系我们的支持团队。
{% endhint %}

***

{% hint style="info" %}
**文档信息**

* 最后更新：2024-12-19
* VergeOS 版本：全部
  {% 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/knowledge-base/zh/system-administration/updating-vergeos-system.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.