> 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/maintenance-mode.md).

# 维护模式

维护模式可使节点准备下线。 **在任何将涉及重启/断电重启或以其他方式使节点不可用的操作之前，应使用维护模式。**

## 将节点置于维护模式

当节点被置于维护模式时，系统会尝试平稳地将所有工作负载（包括虚拟机、租户节点、vNet 容器）迁移到集群中的其他节点。

{% hint style="info" %}
**虚拟机迁移**

无法迁移的虚拟机，例如包含 GPU 设备或使用虚拟化直通（CPU 类型 = 主机处理器）的虚拟机，需要关闭电源，并在另一台合适的节点上重新启动，或在节点维护完成后再次开机。将虚拟机的迁移方式设置为“自动”，可在节点置于维护模式时自动关闭无法迁移的虚拟机；否则，需要手动关闭该虚拟机。
{% endhint %}

{% hint style="warning" %}
在开始任何维护之前，请确认可通过备用方式访问节点服务器，即物理控制台或 IPMI 访问。
{% endhint %}

1. 导航到 **系统** > **节点**.
2. **双击所需的节点** 列表中。
3. 单击 **启用维护模式** 左侧菜单中的。
4. 将出现确认消息。单击 **是** 继续将节点置于维护模式。
5. **监控进度。** 节点仪表板将提供有关维护模式进度的信息：
   * **节点日志**\
     滚动到节点仪表板底部以查看节点日志。系统尝试迁移的每台机器都会出现一条日志记录。指示状态为 *“维护模式”* 表示维护过程成功完成。

     ![节点日志完成](/files/156ba09fc77768eda90e6b1da141334fc0288896)

     如果有任何机器无法迁移，节点日志中会出现错误条目；这些机器需要手动关闭；有关不可迁移工作负载，请参阅上文说明。
   * **正在运行的计算机** 该 *正在运行的计算机* 该部分显示当前位于节点上的工作负载，包括正在运行和正在迁移的。要成功进入维护模式，所有正在运行的机器都需要迁移或关闭；当这一情况发生时，“正在运行的机器”部分将为空。

     ![正在运行的机器 - 一台正在迁移](/files/5b9fc773a087d6925f1124581e90b51aaa2dedb2)
   * **节点状态** 节点状态显示在节点仪表板顶部。当节点正在迁移工作负载时，状态为 ***“迁移中”*** 。

     ![节点状态：迁移中](/files/19ac23631ca32200a3370b9752f2abc26c90afda)

     状态为 ***“维护模式”*** 表示所有工作负载都已成功迁移/关闭。

     ![节点状态：维护模式](/files/28c574848a700a745e7b7d95011e08a4cbd511d3)
6. 在验证 ***节点状态*** 显示 **维护模式**后，执行维护操作，并根据需要使用 **重启** **-和/或-** **关闭电源** 选项（位于节点仪表板左侧菜单中）。
7. **在所有服务完成后** 且节点已准备好再次使用时， **将节点退出维护模式** 以便它可以再次为工作负载提供服务。

## 将节点退出维护模式

{% hint style="success" %}
将节点退出维护状态 **当所有断电重启/重启操作完成时** 且它已准备好恢复服务。
{% endhint %}

1. 从 **节点仪表盘**，单击 **禁用维护模式** 左侧菜单中的。
2. 将出现确认消息。单击 **是** 继续将节点移出维护模式。
3. 该 ***节点状态*** 在退出维护模式的过程中会显示“正在退出维护”。

   ![节点状态：正在退出维护](/files/7c0529b674ca576f40368d0dc75a9035cbabe540)
4. 该 ***节点状态*** 当它完全退出维护模式且工作负载已迁回该节点时，该字段将显示“运行中”。

   ![节点状态：运行中](/files/de827a908dca8d269b77f93a48261674db20ee9d)
5. 如有必要， **为因维护而关闭的任何不可迁移虚拟机或租户节点重新开机**.


---

# 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/maintenance-mode.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.