maprtech/csi-kdfprovisioner

MapR Container Storage Interface (CSI) 存储供应器镜像文档

镜像概述与主要用途

MapR Container Storage Interface (CSI) 存储供应器是MapR提供的容器存储接口（CSI）驱动组件，专为Kubernetes集群设计。作为CSI标准的实现，该镜像用于动态供应和管理MapR存储资源，支持容器化应用通过Kubernetes原生存储机制（如PersistentVolumeClaim、StorageClass）获取持久化存储，实现存储资源的自动化配置、分配与生命周期管理。

主要用途包括：为Kubernetes Pod提供MapR存储（如MapR-FS文件系统、MapR-EFS对象存储）的动态供应；简化容器化应用与MapR存储集群的集成；支持存储策略的灵活配置，满足不同应用的存储需求。

核心功能和特性

1. CSI标准兼容

• 完全符合Container Storage Interface (CSI) v1.x规范，支持Kubernetes CSI驱动的标准部署与集成流程。

2. 动态存储供应

• 支持通过Kubernetes StorageClass定义存储策略，实现PersistentVolume (PV)的动态创建与删除，无需手动配置存储资源。

3. 多类型MapR存储支持

• 兼容MapR多种存储类型，包括：
  • MapR-FS：分布式文件系统，支持高吞吐量、低延迟的文件存储
  • MapR-EFS：企业级文件存储，支持多协议访问（NFS、SMB）
  • MapR-ObjectStore：兼容S3 API的对象存储

4. 存储策略自定义

• 支持通过StorageClass参数配置存储属性，如：
  • 存储副本数（replica count）
  • 数据 locality 策略（本地节点优先或跨节点分布）
  • QoS配置（吞吐量、IOPS限制）
  • 数据加密与访问控制策略

5. 与Kubernetes原生存储资源集成

• 无缝对接Kubernetes存储资源模型：
  • 通过StorageClass定义存储模板
  • 通过PersistentVolumeClaim (PVC) 请求存储资源
  • 支持Pod挂载PV实现持久化存储访问

6. 自动化存储生命周期管理

• 支持PV的动态扩容（需StorageClass开启allowVolumeExpansion: true）
• 基于PVC回收策略（Retain/Delete/Recycle）自动管理存储资源生命周期

使用场景和适用范围

适用场景

• 容器化数据库应用：如MySQL、PostgreSQL等需要持久化数据的数据库，通过动态供应的MapR存储确保数据可靠性。
• 大数据处理应用：如Spark、Flink等分布式计算框架，利用MapR-FS的高吞吐量特性存储海量数据集。
• 共享存储需求的多Pod应用：如Web服务集群、内容管理系统，通过MapR-EFS实现多Pod共享访问同一存储资源。
• 对象存储依赖的应用：如需要S3兼容存储的备份工具、媒体服务，通过MapR-ObjectStore提供兼容接口。

适用范围

• 已部署MapR存储集群的企业级Kubernetes环境
• Kubernetes版本要求：v1.18+（CSI v1.0+支持）
• 需具备MapR集群访问权限（网络连通性、认证凭据）

详细使用方法和配置说明

前置条件

1. Kubernetes集群（v1.18+），已配置CSI驱动基础环境（如kubelet CSI插件目录挂载）
2. 可访问的MapR存储集群，已获取集群名称、访问地址及认证凭据（如ticket文件、用户名/密码）
3. 集群网络配置：确保Kubernetes节点与MapR集群节点之间网络连通（默认端口：MapR-FS 9000/TCP，MapR-EFS 2049/TCP）

部署步骤

1. 部署CSI驱动组件

MapR CSI存储供应器需与MapR CSI节点驱动配合使用，通常通过YAML清单部署：

bash
# 部署CSI控制器组件（包含供应器）
kubectl apply -f https://mapr.com/docs/latest/kubernetes/csi/mapr-csi-controller.yaml

# 部署CSI节点组件
kubectl apply -f https://mapr.com/docs/latest/kubernetes/csi/mapr-csi-node.yaml

2. 配置MapR认证

创建包含MapR集群认证信息的Secret（如ticket文件）：

yaml
apiVersion: v1
kind: Secret
metadata:
  name: mapr-csi-secret
  namespace: kube-system
type: Opaque
data:
  # 注意：ticket内容需base64编码
  mapr-ticket: <base64-encoded-mapr-ticket>

3. 创建StorageClass

定义存储类，指定MapR存储类型及策略：

yaml
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: mapr-fs-sc
provisioner: com.mapr.csi
parameters:
  # MapR集群名称
  maprCluster: my-mapr-cluster
  # 存储类型：mapr-fs/mapr-efs/mapr-objectstore
  storageType: mapr-fs
  # 副本数（1-3）
  replicas: "3"
  # 数据 locality策略：node-local/rack-aware
  locality: "rack-aware"
  # 挂载点路径（MapR集群内的路径）
  mountPath: "/data/k8s"
reclaimPolicy: Delete
allowVolumeExpansion: true

4. 创建PersistentVolumeClaim

通过PVC请求存储资源：

yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: mapr-fs-pvc
spec:
  accessModes:
    - ReadWriteMany  # 支持多Pod读写
  storageClassName: mapr-fs-sc
  resources:
    requests:
      storage: 50Gi  # 请求50GiB存储

5. 在Pod中使用PVC

yaml
apiVersion: v1
kind: Pod
metadata:
  name: mapr-storage-demo
spec:
  containers:
  - name: demo-app
    image: nginx:alpine
    volumeMounts:
    - name: data-volume
      mountPath: /usr/share/nginx/html
  volumes:
  - name: data-volume
    persistentVolumeClaim:
      claimName: mapr-fs-pvc

配置参数说明

StorageClass参数

环境变量配置（控制器部署）

在部署CSI控制器时，可通过环境变量调整供应器行为：

注意事项

1. 认证凭据管理：MapR认证信息（如ticket）需通过Kubernetes Secret安全存储，避免明文暴露。
2. 存储性能调优：根据应用需求调整replicas和locality参数，平衡性能与可靠性。
3. 版本兼容性：确保MapR CSI供应器版本与MapR集群版本匹配（参考MapR官方兼容性矩阵）。
4. 网络隔离：若Kubernetes与MapR集群跨网络部署，需配置防火墙规则开放必要端口（如9000、8443）。