openebs/mayastor-agent-ha-cluster

Mayastor Nexus HA Controller 镜像文档

镜像概述

Mayastor Nexus HA Controller 是 Mayastor 分布式存储系统的核心控制平面组件，作为 Nexus 高可用（HA）控制器，主要负责协调存储集群的高可用性功能，包括管理 Nexus 实例的生命周期、监控集群状态、处理故障转移以及确保数据服务的持续可用。该镜像为 Mayastor 存储集群提供关键的控制逻辑，是实现存储服务高可用性的核心组件。

核心功能与特性

1. 高可用协调

• 管理 Nexus 实例的创建、配置与销毁，确保存储卷的高可用部署
• 协调多节点间的 Nexus 副本分布，实现数据冗余与故障容错
• 监控 Nexus 实例健康状态，触发自动故障转移机制

2. 集群状态管理

• 实时跟踪存储集群中节点、磁盘及资源的运行状态
• 维护集群拓扑信息，为高可用决策提供数据支持
• 支持动态更新集群成员及资源配置

3. 配置同步与一致性

• 确保集群节点间高可用配置的一致性同步
• 支持配置参数的动态调整与生效
• 维护 Nexus 实例与后端存储资源的映射关系

4. 故障检测与恢复

• 内置故障检测机制，监控节点、网络及服务健康状态
• 自动触发故障恢复流程，如资源重分配、副本重建等
• 支持手动干预与自动恢复模式切换

使用场景与适用范围

适用场景

• 基于 Mayastor 的分布式存储集群部署
• 需要高可用性保障的企业级存储环境
• 云原生 Kubernetes 集群中的持久化存储后端
• 对数据服务连续性要求高的关键业务系统

适用范围

• 与 Mayastor 存储系统其他组件（如 etcd、io-engine）配合使用
• 支持单区域或跨区域的存储集群架构
• 兼容主流 Linux 操作系统及容器化部署环境

使用方法与配置说明

前置条件

• 已部署 Mayastor 存储集群基础组件（如 etcd、节点代理）
• 集群节点间网络互通，确保控制平面通信端口开放
• 具备容器运行时环境（Docker 或 containerd）

部署示例

Docker Run 部署

bash
docker run -d \
  --name mayastor-nexus-ha-controller \
  --network=host \
  -e MAYASTOR_CLUSTER_ADDR=etcd://<etcd-endpoint>:2379 \
  -e NEXUS_HA_LOG_LEVEL=info \
  -e HEARTBEAT_INTERVAL=5s \
  -e FAILOVER_TIMEOUT=30s \
  -v /var/lib/mayastor/nexus-ha:/etc/mayastor/nexus-ha \
  mayastor/nexus-ha-controller:latest

Kubernetes 部署（简化示例）

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: mayastor-nexus-ha-controller
  namespace: mayastor
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nexus-ha-controller
  template:
    metadata:
      labels:
        app: nexus-ha-controller
    spec:
      containers:
      - name: controller
        image: mayastor/nexus-ha-controller:latest
        env:
        - name: MAYASTOR_CLUSTER_ADDR
          value: "etcd://etcd-service:2379"
        - name: NEXUS_HA_LOG_LEVEL
          value: "info"
        volumeMounts:
        - name: config-volume
          mountPath: /etc/mayastor/nexus-ha
      volumes:
      - name: config-volume
        configMap:
          name: nexus-ha-config

核心配置参数

注意事项

• 需确保与 Mayastor 集群其他组件版本兼容（建议使用相同版本系列）
• 生产环境建议配置资源限制（CPU/内存）以保障稳定性
• 高可用部署时，控制器本身建议通过 Kubernetes Deployment 或类似机制实现多副本冗余
• 网络延迟可能影响心跳检测与故障转移效率，建议控制节点间网络延迟在 10ms 以内