4. 控制平面组件详解（下）

本章深入剖析Longhorn控制平面的最后三个关键组件：用户交互层（UI）、实时通信通道（WebSocket）以及核心执行单元（Instance Manager）。理解这三者的协作关系，是定位控制平面故障、分析节点异常和调试卷挂载问题的前提。

4.1 Longhorn UI架构：从浏览器到API的请求链路

Longhorn UI是一个基于React的单页应用（SPA），部署在Longhorn Manager Pod内部，通过Ingress或NodePort对外暴露。其架构遵循典型的“视图层 → 服务层 → API层”分层模型。

4.2 WebSocket通信机制：实时状态推送与事件驱动

Longhorn UI通过WebSocket与Manager建立持久连接，实现控制平面状态的实时更新。这是区别于传统轮询模式的关键设计，显著降低了API Server的负载并提升了用户体验。

4.2.1 连接建立与生命周期

• 握手阶段： UI在加载完成后，向Manager的 /v1/ws 端点发起WebSocket升级请求，携带认证。
• 订阅机制： 连接建立后，UI发送订阅消息，指定需要监听的资源类型（如volume、engine、replica、node、instance-manager）。
• 推送模式： Manager通过informer机制监听CRD变化，一旦检测到状态变更，立即序列化为JSON并通过WebSocket推送给所有订阅该资源的UI客户端。
• 心跳保活： 默认每30秒发送一次ping帧；若连续3次pong超时，UI侧主动断开并触发重连逻辑。

4.2.2 消息格式与事件类型

4.3 Instance Manager的角色与生命周期管理

Instance Manager是Longhorn控制平面与数据平面之间的桥梁。它不是一个存储数据的进程，而是负责管理Engine和Replica实例生命周期的代理组件。每个运行Engine或Replica的节点上，至少运行一个Instance Manager Pod。

4.3.1 核心职责

• 进程编排： 根据Manager的指令，在节点上启动、停止、监控Engine和Replica进程。
• 资源隔离： 通过cgroup限制Engine/Replica的CPU、内存和磁盘IO，防止单个实例影响节点稳定性。
• 健康探测： 定期对管理的实例进行gRPC健康检查，异常时上报Manager并触发自动恢复流程。
• 端口管理： 为每个Engine实例分配和管理数据面通信端口（默认TCP 10000-20000范围），确保端口不冲突。

4.3.2 类型与部署模式

4.3.3 生命周期状态机

Instance Manager的状态由Manager通过CRD instancemanager.longhorn.io 控制，状态转换如下：

4.3.4 关键操作与故障场景

• 启动流程： Manager创建Instance Manager Pod → Pod内进程初始化gRPC服务 → 向Manager上报ready状态 → Manager将CRD状态更新为 running。
• 实例管理： 当需要创建新Engine/Replica时，Manager通过gRPC调用Instance Manager的 ProcessCreate 接口，传递卷规格、副本位置等参数。
• 故障恢复： 如果Instance Manager Pod所在的节点宕机，Manager通过Pod的 status.conditions 检测到异常，将CRD状态置为 error，并在其他可用节点上重新调度Instance Manager，然后重建其管理的所有Engine/Replica实例。

4.4 组件协作流程：一次卷挂载请求的完整路径

为了将上述组件串联起来，我们以用户通过UI挂载一个卷为例，展示控制平面的完整协作流程：

1. UI操作： 用户在卷详情页点击“Attach”，选择目标节点。
2. WebSocket推送： UI通过REST API发送attach请求，Manager处理请求后，通过WebSocket向所有UI实例推送 volume.change 事件，更新卷状态为 attaching。
3. Manager调度： Manager根据调度策略，选择目标节点上的 instance-manager-e，通过gRPC调用 ProcessCreate 启动Engine实例。
4. Engine启动： Engine实例启动后，连接到所有Replica（通过 instance-manager-r 暴露的gRPC端点），开始数据同步。
5. 状态上报： Engine和Replica的健康状态通过Instance Manager上报给Manager，Manager更新CRD状态。
6. UI更新： WebSocket推送最终状态 attached，UI显示卷已挂载并展示数据面端点。