openebs/mayastor-csi-controller

Mayastor CSI Driver Controller Service

概述

Mayastor CSI Driver Controller Service是Mayastor存储系统的核心控制平面组件，实现了Container Storage Interface (CSI)规范。该服务负责与Kubernetes API服务器交互，协调和管理集群存储资源，处理存储卷的创建、删除、扩容、快照等全生命周期操作，是Mayastor在Kubernetes环境中提供分布式存储服务的关键控制节点。

核心功能

1. 存储卷生命周期管理

• 处理Kubernetes PVC/PV的创建、删除请求，完成存储卷的实例化与清理
• 支持卷扩容操作，根据PVC扩容请求调整存储卷容量
• 提供卷快照及快照恢复功能，支持基于快照创建新卷

2. 存储资源协调

• 监控和管理Mayastor存储池（Storage Pool）状态，协调存储资源分配
• 基于存储池容量、性能特性动态调度卷创建请求
• 支持存储资源的动态发现与注册

3. Kubernetes集成

• 遵循CSI v1.x规范，实现CSI Controller服务接口
• 与Kubernetes Scheduler交互，提供拓扑感知的卷调度能力（基于节点标签、存储池分布）
• 支持Kubernetes StorageClass资源，允许通过StorageClass定义存储卷属性（如副本数、性能策略）

4. 高可用性保障

• 协调卷的多副本配置与同步，确保数据高可用
• 监控卷副本状态，触发故障检测与自动恢复流程
• 支持跨节点存储拓扑，实现存储资源的冗余部署

使用场景

• Kubernetes分布式存储部署：作为Mayastor存储系统的控制平面组件，在Kubernetes集群中部署Mayastor时必须运行
• 容器化应用存储管理：为需要动态存储配置的容器化应用提供存储卷生命周期自动化管理
• 生产级存储环境：适用于对存储性能、可靠性和可扩展性有要求的生产环境，如数据库、消息队列等有状态应用
• 混合存储架构：配合Mayastor数据平面组件，管理本地磁盘、NVMe、SSD等多种存储介质组成的存储池

使用方法

部署环境要求

• Kubernetes集群版本：v1.20+
• Mayastor数据平面组件（mayastor-agent、mayastor-server）已部署
• 集群节点需配置CSI相关权限（RBAC）

部署方式

通常通过Kubernetes Deployment资源部署，示例配置如下：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: mayastor-csi-controller
  namespace: mayastor
spec:
  replicas: 1  # 生产环境建议多副本部署以提高可用性
  selector:
    matchLabels:
      app: mayastor-csi-controller
  template:
    metadata:
      labels:
        app: mayastor-csi-controller
    spec:
      serviceAccountName: mayastor-csi-controller-sa
      containers:
      - name: csi-controller
        image: mayadata/mayastor-csi-controller:latest  # 替换为实际版本
        args:
          - --csi-endpoint=unix:///csi/csi.sock
          - --node-id=$(NODE_NAME)
          - --log-level=info
        env:
        - name: NODE_NAME
          valueFrom:
            fieldRef:
              fieldPath: spec.nodeName
        volumeMounts:
        - name: csi-socket-dir
          mountPath: /csi
      volumes:
      - name: csi-socket-dir
        emptyDir: {}

核心配置参数

依赖组件

• Kubernetes API Server：用于交互PVC/PV/StorageClass等资源
• Mayastor存储池：需提前部署并注册存储池（通过MayastorPool CRD）
• CSI Sidecar容器：通常与csi-provisioner、csi-attacher等CSI辅助容器协同工作，处理CSI规范中的特定阶段操作

监控与日志

• 日志输出：标准输出（可通过Kubernetes kubectl logs查看）
• 指标暴露：通过--metrics-addr指定的地址暴露Prometheus指标，包含卷操作成功率、存储池使用率、API请求延迟等关键指标

注意事项

• 控制器服务为有状态组件，生产环境建议部署多副本（配合 leader election）确保高可用
• 存储池配置变更需通过MayastorPool CRD操作，控制器服务将自动感知并更新存储资源信息
• 升级前需确保与Mayastor数据平面组件版本兼容，避免版本不一致导致功能异常