k8s.gcr.io/sig-storage/csi-resizer 镜像文档

镜像概述和主要用途

csi-resizer 是 Kubernetes 容器存储接口 (CSI) 的辅助组件，用于支持 CSI 驱动的持久卷 (PVC) 动态扩容功能。该组件监听 Kubernetes 集群中持久卷声明 (PVC) 的扩容请求，并与 CSI 驱动交互以执行实际的卷大小调整操作，实现存储资源的弹性伸缩。

核心功能和特性

• 支持 CSI 规范定义的卷扩容操作
• 监听 Kubernetes API 中 PVC 的容量变更事件
• 与 CSI 驱动协调执行卷大小调整流程
• 自动更新 Kubernetes 资源状态以反映实际卷大小
• 支持 leader 选举机制，确保高可用性
• 提供详细的日志记录用于问题排查

使用场景和适用范围

• 需要动态调整持久卷大小的 Kubernetes 集群环境
• 使用符合 CSI 规范且支持卷扩容功能的存储驱动
• 需要根据应用需求灵活扩展存储资源的场景
• 多团队共享集群资源，需要精细化存储管理的环境
• 希望避免因存储容量不足导致应用故障的生产系统

使用方法和配置说明

部署要求

• Kubernetes 集群版本 v1.16+
• 已部署并配置支持扩容功能的 CSI 驱动
• 集群具备适当的 RBAC 权限配置

基本部署方式

csi-resizer 通常作为 Deployment 在 Kubernetes 集群中运行，与 CSI 驱动组件协同工作：

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:
      containers:
      - name: csi-resizer
        image: k8s.gcr.io/sig-storage/csi-resizer:v1.7.0
        args:
        - --v=5
        - --csi-address=/csi/csi.sock
        - --leader-election=true
        volumeMounts:
        - name: socket-dir
          mountPath: /csi
      volumes:
      - name: socket-dir
        hostPath:
          path: /var/lib/kubelet/plugins/<csi-driver-name>
          type: DirectoryOrCreate

配置参数

Docker 运行示例

虽然 csi-resizer 通常在 Kubernetes 集群内部署，也可通过 Docker 直接运行（主要用于测试）：

docker run --name csi-resizer k8s.gcr.io/sig-storage/csi-resizer:v1.7.0 \
  --v=5 \
  --csi-address=/csi/csi.sock \
  --kubeconfig=/etc/kubernetes/admin.conf \
  --leader-election=false

环境变量

RBAC 权限配置

csi-resizer 需要以下 RBAC 权限才能正常工作：

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

故障排除

1. 卷扩容失败：

   • 检查 CSI 驱动是否支持扩容功能
   • 验证存储后端是否有足够的可用空间
   • 查看 csi-resizer 日志获取详细错误信息

2. 无法启动：

   • 检查 CSI 驱动套接字路径是否正确
   • 验证 RBAC 权限是否配置正确
   • 确认与 Kubernetes API 服务器的网络连接

3. 日志查看：

   kubectl logs -n kube-system deployment/csi-resizer -f
   

版本兼容性

注意事项

• 卷扩容功能需要 CSI 驱动明确支持，并非所有 CSI 驱动都实现了此功能
• 扩容操作可能受存储后端限制，某些存储系统可能不支持在线扩容
• 调整 PVC 大小后，还需确保文件系统已正确扩展（某些环境需要手动执行）
• 生产环境中建议启用 leader 选举以确保高可用性