longhornio/csi-resizer

CSI Resizer

概述和主要用途

CSI Resizer是Container Storage Interface (CSI)规范定义的辅助组件，用于实现Kubernetes集群中持久卷声明（PersistentVolumeClaim, PVC）的动态扩容。其核心功能是监控PVC的存储容量变更请求，通过与CSI存储驱动交互执行卷扩容操作，并同步更新Kubernetes资源状态，为应用提供弹性存储能力。

核心功能和特性

核心功能

• PVC容量监控：实时检测PVC对象spec.resources.requests.storage字段的变更，触发扩容流程
• CSI驱动交互：通过CSI标准接口（ControllerExpandVolume/NodeExpandVolume）与存储驱动协同完成卷容量调整
• 资源状态同步：扩容完成后自动更新PV容量信息及PVC状态（如status.capacity.storage）
• 故障处理：支持扩容失败后的状态回滚与重试机制

特性

• 标准兼容性：遵循CSI 1.0+规范，兼容所有实现扩容接口的存储驱动
• 高可用性：支持Leader Election机制，多副本部署时确保操作唯一性
• 轻量级设计：资源占用低，可作为DaemonSet或Deployment灵活部署
• 可观测性：提供Prometheus指标暴露（默认:8080端口）及结构化日志输出

使用场景和适用范围

使用场景

• 动态存储调整：数据库、日志系统等需随业务增长扩容存储的应用
• 资源优化：避免初始存储分配过大导致的资源浪费，实现"按需扩容"
• 业务连续性：支持在线扩容（无需重启应用），保障服务持续可用
• 自动化运维：减少人工介入，通过Kubernetes API自动完成存储扩容

适用范围

• 环境要求：Kubernetes集群（v1.16+，推荐v1.20+以支持完整功能）
• 驱动依赖：需配合实现CSI ControllerExpandVolume接口的存储驱动
• 存储类型：支持块存储（Block）和文件存储（File），具体取决于驱动实现
• 权限要求：运行组件需具备PVC/PV/CSINode等资源的访问权限

详细的使用方法和配置说明

部署方式

CSI Resizer通常以Pod形式部署在Kubernetes集群中，推荐通过Deployment部署（控制平面组件模式），配合CSI驱动的Socket通信实现功能。

Kubernetes Deployment示例

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: csi-resizer
  namespace: kube-system
spec:
  replicas: 1
  selector:
    matchLabels:
      app: csi-resizer
  template:
    metadata:
      labels:
        app: csi-resizer
    spec:
      serviceAccountName: csi-resizer-sa
      containers:
      - name: csi-resizer
        image: registry.k8s.io/sig-storage/csi-resizer:v1.8.0
        args:
        - --v=5
        - --csi-address=/csi/csi.sock
        - --driver-name=my-csi-driver.example.com
        - --leader-election=true
        - --metrics-addr=:8080
        volumeMounts:
        - name: socket-dir
          mountPath: /csi
        ports:
        - containerPort: 8080
          name: metrics
      volumes:
      - name: socket-dir
        hostPath:
          path: /var/lib/csi/sockets/pluginproxy/csi-resizer
          type: DirectoryOrCreate

配置参数说明

命令行参数

环境变量

支持通过环境变量配置（优先级低于命令行参数）：

权限配置（RBAC）

运行CSI Resizer的ServiceAccount需具备以下权限（最小权限原则）：

yaml
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: csi-resizer-role
rules:
- apiGroups: [""]
  resources: ["persistentvolumes"]
  verbs: ["get", "list", "watch", "update", "patch"]
- apiGroups: [""]
  resources: ["persistentvolumeclaims"]
  verbs: ["get", "list", "watch", "update"]
- apiGroups: [""]
  resources: ["events"]
  verbs: ["create", "update", "patch"]
- apiGroups: ["storage.k8s.io"]
  resources: ["csinodes"]
  verbs: ["get", "list", "watch"]
- apiGroups: ["storage.k8s.io"]
  resources: ["storageclasses"]
  verbs: ["get", "list", "watch"]

部署注意事项

1. 驱动兼容性：确认存储驱动已实现ControllerExpandVolume接口（节点侧扩容需NodeExpandVolume）
2. Kubernetes配置：v1.24以下集群需启用VolumePVCResize特性门控
3. 存储类配置：PVC所在StorageClass需设置allowVolumeExpansion: true
4. 安全配置：通过Unix域套接字与CSI驱动通信，避免网络暴露风险
5. 版本匹配：建议使用与Kubernetes集群版本匹配的CSI Resizer版本（如K8s v1.28对应resizer v1.8.x）