openebs/mayastor-agent-core

Mayastor Core Control Plane 镜像文档

镜像概述和主要用途

Mayastor Core Control Plane镜像是Mayastor云原生存储解决方案的核心组件，承担存储系统的控制平面功能。作为整个存储架构的协调中枢，其主要职责包括存储资源的分配与调度、卷生命周期管理（创建、删除、快照、复制等）、高可用性保障及与编排平台的集成，是构建Mayastor分布式存储系统的关键基础组件。

核心功能和特性

1. 存储资源管理

• 动态发现集群内存储节点及介质（SSD/HDD），实时监控资源利用率
• 基于策略的存储资源调度，优化存储分配效率
• 支持存储池创建、扩容及性能配置管理

2. 卷生命周期管理

• 处理块存储卷的全生命周期操作（创建、删除、扩容、缩容）
• 提供卷快照、克隆、跨节点复制等高级数据服务
• 维护卷元数据一致性，确保数据可靠性

3. 高可用协调

• 协调节点故障时的自动数据恢复流程
• 管理卷副本策略，支持跨可用区部署以提升容错能力
• 实现存储服务的故障检测与自动修复

4. 云原生集成

• 原生支持Kubernetes API，通过CRD（CustomResourceDefinition）暴露存储管理接口
• 兼容Kubernetes动态卷供应（Dynamic Provisioning）及存储类（StorageClass）
• 支持与Prometheus、Grafana等可观测性工具集成，提供 metrics 数据

5. 配置与策略管理

• 支持自定义存储策略（如副本数、IO优先级、QoS限制）
• 提供灵活的参数配置接口，适配不同业务场景需求

使用场景和适用范围

典型使用场景

• Kubernetes集群中的分布式块存储部署
• 云原生有状态应用（数据库、消息队列、分布式缓存等）的持久化存储需求
• 需要动态扩缩容、数据高可用及灾备能力的生产环境
• 对存储性能（低延迟、高IOPS）有严格要求的业务场景

适用范围

• 容器化部署的云原生基础设施
• 具备Kubernetes集群管理能力的技术团队
• 需构建弹性、分布式存储层的企业级数据中心
• 混合云/多云环境下的统一存储管理

使用方法和配置说明

前置条件

• 运行环境：Docker 20.10+ 或容器运行时（containerd 1.4+）
• 依赖组件：etcd集群（3.4+，用于元数据存储）、Kubernetes集群（1.21+，若需云原生集成）
• 网络要求：控制平面需与存储节点（数据平面）、etcd及Kubernetes API保持网络连通

Docker Run 部署示例

bash
docker run -d \
  --name mayastor-control-plane \
  --net=host \
  --restart=unless-stopped \
  -e ETCD_ENDPOINTS=http://etcd-node1:2379,http://etcd-node2:2379 \
  -e LOG_LEVEL=info \
  -e KUBE_CONFIG=/etc/kubernetes/admin.conf \
  -e PORT=50051 \
  -v /etc/kubernetes/admin.conf:/etc/kubernetes/admin.conf \
  -v /var/lib/mayastor/control-plane:/var/lib/mayastor \
  -v /var/log/mayastor:/var/log \
  mayastor/core-control-plane:latest

核心环境变量配置

Docker Compose 部署示例

yaml
version: '3.8'
services:
  mayastor-control-plane:
    image: mayastor/core-control-plane:latest
    container_name: mayastor-control-plane
    network_mode: host
    restart: unless-stopped
    environment:
      - ETCD_ENDPOINTS=http://etcd-0:2379,http://etcd-1:2379,http://etcd-2:2379
      - LOG_LEVEL=info
      - KUBE_CONFIG=/etc/kubernetes/admin.conf
      - PORT=50051
      - REPLICATION_FACTOR=3
    volumes:
      - /etc/kubernetes/admin.conf:/etc/kubernetes/admin.conf
      - /var/lib/mayastor/control-plane:/var/lib/mayastor
      - /var/log/mayastor-control-plane:/var/log
    resources:
      limits:
        cpu: 2
        memory: 4Gi
      requests:
        cpu: 1
        memory: 2Gi

注意事项

1. 版本兼容性：控制平面版本需与Mayastor数据平面（mayastor-agent）严格一致，避免功能不兼容。
2. etcd配置：建议etcd集群采用3节点以上部署，开启数据持久化，确保元数据安全。
3. 资源规划：生产环境建议分配2 CPU核心/4GB内存，集群规模超过100节点时需适当扩容资源。
4. 安全配置：通过环境变量或配置文件启用TLS加密（如etcd连接、API通信），避免明文传输敏感信息。
5. 监控告警：配置Prometheus采集metrics（默认暴露于:9090/metrics），设置资源使用率、节点健康状态等关键指标告警。

注：具体功能及配置可能因镜像版本不同存在差异，建议结合官方文档进行部署调优。