k8scsi/csi-attacher

k8scsi/csi-attacher 镜像说明

镜像概述

k8scsi/csi-attacher是Kubernetes容器存储接口（CSI）的核心组件之一，负责监听集群中CSI卷的附加/分离请求，并与CSI驱动交互完成操作，保障容器与存储卷的连接管理。

核心功能

1. 监听K8s API中CSI卷的附加、分离事件
2. 与CSI驱动通信执行卷的附加/分离操作
3. 更新卷状态至K8s集群，确保状态一致性
4. 处理操作异常，提升可靠性

使用场景

• 部署第三方CSI存储插件（如Ceph CSI、NFS CSI）时的必要依赖
• 支持K8s动态卷供应，为Pod提供持久化存储的附加能力

配置说明

关键配置参数：

• CSI_ENDPOINT：CSI驱动的通信端点（例：unix:///csi/csi.sock）
• KUBE_CONFIG_PATH：集群外运行时的kubeconfig路径
• --v：日志详细级别（默认0，数值越大日志越详细）

部署示例

Kubernetes集群中部署csi-attacher的Deployment示例：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: csi-attacher
  namespace: kube-system
spec:
  replicas: 1
  selector:
    matchLabels:
      app: csi-attacher
  template:
    metadata:
      labels:
        app: csi-attacher
    spec:
      containers:
      - name: csi-attacher
        image: k8scsi/csi-attacher:latest
        args:
        - --csi-address=$(CSI_ENDPOINT)
        - --v=3
        env:
        - name: CSI_ENDPOINT
          value: unix:///csi/csi.sock
        volumeMounts:
        - name: csi-socket
          mountPath: /csi
      volumes:
      - name: csi-socket
        hostPath:
          path: /var/lib/csi/sockets/pluginproxy/
          type: DirectoryOrCreate