gluster/glusterfs-csi-driver

镜像概述

该镜像为GlusterFS的CSI（Container Storage Interface）驱动实现，专门兼容GD2（GlusterD 2.0）管理的GlusterFS存储集群。CSI驱动作为容器编排平台（如Kubernetes）与存储系统间的标准化接口，可将GlusterFS的分布式存储能力集成到容器环境中，为应用提供持久化存储服务。

核心功能和特性

1. CSI规范兼容

• 遵循CSI 1.0+规范，支持控制器服务（Controller Service）和节点服务（Node Service），实现与容器编排平台的标准化集成。

2. GD2兼容性

• 原生支持GD2（GlusterD 2.0）管理的GlusterFS集群，可通过GD2的REST API进行集群状态查询、卷操作等管理功能。

3. 动态存储配置

• 支持通过Kubernetes StorageClass动态创建GlusterFS卷，无需手动预配置存储资源。

4. 卷生命周期管理

• 提供卷创建、删除、挂载、卸载等完整生命周期管理能力，支持卷扩展（需GlusterFS集群支持）。

5. 高可用性支持

• 兼容GlusterFS的分布式、复制式卷类型，确保存储数据的高可用和冗余。

使用场景和适用范围

适用环境

• Kubernetes集群（1.14+版本，需启用CSI功能）。
• 由GD2管理的GlusterFS存储集群（GlusterFS 6.0+版本）。

典型应用场景

• 数据库应用（如MySQL、PostgreSQL）需要持久化存储的场景。
• 文件共享服务（如NFS替代方案）在容器环境中的部署。
• 对存储性能、可靠性有要求的有状态应用（StatefulSet）。

使用方法和配置说明

前置条件

1. 已部署GD2管理的GlusterFS集群，并确保集群健康运行。
2. Kubernetes集群已启用CSI功能（如kubelet配置--feature-gates=CSINodeInfo=true,CSIDriverRegistry=true）。
3. 网络互通：Kubernetes节点需能访问GlusterFS集群节点及GD2的REST API端口（默认24007）。

部署步骤

1. 部署CSI驱动组件

通过Kubernetes YAML清单部署CSI控制器和节点插件（以下为示例，具体清单需根据实际环境调整）：

yaml
# csi-glusterfs-controller.yaml（控制器组件）
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: csi-glusterfs-controller
  namespace: kube-system
spec:
  serviceName: "csi-glusterfs"
  replicas: 1
  selector:
    matchLabels:
      app: csi-glusterfs-controller
  template:
    metadata:
      labels:
        app: csi-glusterfs-controller
    spec:
      serviceAccountName: csi-glusterfs-controller-sa
      containers:
        - name: csi-provisioner
          image: k8s.gcr.io/sig-storage/csi-provisioner:v3.1.0
          args:
            - "--csi-address=$(ADDRESS)"
            - "--v=5"
          env:
            - name: ADDRESS
              value: /var/lib/csi/sockets/pluginproxy/csi.sock
          volumeMounts:
            - name: socket-dir
              mountPath: /var/lib/csi/sockets/pluginproxy/
        - name: glusterfs-csi-driver
          image: <镜像名称:标签>  # 替换为实际镜像名称
          args:
            - "--endpoint=$(CSI_ENDPOINT)"
            - "--nodeid=$(NODE_ID)"
            - "--drivername=glusterfs.csi.k8s.io"
          env:
            - name: CSI_ENDPOINT
              value: unix:///var/lib/csi/sockets/pluginproxy/csi.sock
            - name: NODE_ID
              valueFrom:
                fieldRef:
                  fieldPath: spec.nodeName
          volumeMounts:
            - name: socket-dir
              mountPath: /var/lib/csi/sockets/pluginproxy/
            - name: glusterfs-config
              mountPath: /etc/glusterfs
              readOnly: true
      volumes:
        - name: socket-dir
          emptyDir: {}
        - name: glusterfs-config
          configMap:
            name: glusterfs-config  # 包含GlusterFS集群配置的ConfigMap

2. 创建StorageClass

定义Kubernetes StorageClass，指定CSI驱动及GlusterFS集群参数：

yaml
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: glusterfs-csi-sc
provisioner: glusterfs.csi.k8s.io
parameters:
  resturl: "http://gd2-endpoint:24007"  # GD2的REST API地址（多个地址用逗号分隔）
  restuser: "admin"                     # GD2管理员用户名（如启用认证）
  secretName: "glusterfs-secret"        # 存储认证信息的Secret名称（如启用认证）
  secretNamespace: "kube-system"        # Secret所在命名空间
  volumetype: "replicate:3"             # GlusterFS卷类型（如replicate、distribute）
reclaimPolicy: Delete  # 卷回收策略（Delete/Retain）
allowVolumeExpansion: true  # 允许卷扩展（需GlusterFS支持）

3. 创建PersistentVolumeClaim（PVC）

通过PVC动态申请存储：

yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: glusterfs-csi-pvc
spec:
  accessModes:
    - ReadWriteMany  # GlusterFS支持的访问模式（ReadWriteOnce/ReadWriteMany/ReadOnlyMany）
  resources:
    requests:
      storage: 10Gi  # 请求存储容量
  storageClassName: glusterfs-csi-sc  # 关联上述StorageClass

配置参数说明

注意事项

1. 网络安全：确保GlusterFS集群与Kubernetes节点间的网络通畅，必要时配置防火墙规则开放GlusterFS端口（如24007、49152-49251）。
2. 认证配置：若GD2启用了认证，需创建包含用户名和密码的Secret，并在StorageClass中指定。
3. 版本兼容性：建议使用GlusterFS 6.0+版本及Kubernetes 1.14+版本，以确保CSI功能正常支持。
4. 卷扩展：启用allowVolumeExpansion后，需确保GlusterFS集群支持卷扩展（如使用thin-arbiter或replicate卷类型）。