angelnu/cifs_k8s_plugin

CIFS插件 for Kubernetes

镜像概述

该镜像提供适用于Kubernetes的CIFS（Common Internet File System）存储插件，支持amd64、arm、arm64多种硬件架构。作为Kubernetes存储扩展，它允许集群中的Pod通过CIFS/SMB协议挂载网络共享存储，实现跨节点的存储资源访问。

核心功能与特性

• 多架构支持：兼容amd64（x86_64）、arm（32位ARM）、arm64（64位ARM）架构，适用于混合架构Kubernetes集群
• CIFS/SMB协议兼容：支持主流CIFS/SMB协议版本，可对接Windows文件共享、Samba服务器等CIFS服务
• Kubernetes集成：符合Kubernetes CSI（Container Storage Interface）规范，可作为StorageClass的provisioner使用
• 动态卷管理：支持通过PersistentVolumeClaim（PVC）动态创建和挂载CIFS存储卷

使用场景与适用范围

• 混合架构集群：在包含x86服务器、ARM开发板、ARM服务器等混合架构节点的Kubernetes集群中使用
• 网络共享存储接入：需要将企业内部CIFS/SMB共享存储（如Windows文件服务器、Samba共享）挂载到Pod的场景
• 跨节点数据共享：适用于需要多Pod、多节点共享访问同一存储资源的应用（如分布式应用、日志收集服务）
• 边缘计算环境：在ARM架构为主的边缘计算Kubernetes集群中提供标准化存储接入能力

使用方法与配置说明

部署前提

• Kubernetes集群版本1.14+（支持CSI 1.0+）
• 集群节点已安装cifs-utils工具（用于CIFS挂载）
• 可访问的CIFS/SMB服务器及有效的访问凭证

部署步骤

1. 部署CSI驱动
   通过DaemonSet部署插件到集群所有节点（根据架构自动拉取对应镜像）：

   yaml
   # 示例DaemonSet片段
   apiVersion: apps/v1
   kind: DaemonSet
   metadata:
     name: cifs-csi-node
     namespace: kube-system
   spec:
     selector:
       matchLabels:
         app: cifs-csi-node
     template:
       metadata:
         labels:
           app: cifs-csi-node
       spec:
         containers:
         - name: cifs-csi-driver
           image: [镜像名称]  # 实际使用时替换为该CIFS插件镜像地址
           securityContext:
             privileged: true
           volumeMounts:
           - name: mountpoint-dir
             mountPath: /var/lib/kubelet/pods
           - name: plugin-dir
             mountPath: /var/lib/kubelet/plugins/cifs.csi.k8s.io
         volumes:
         - name: mountpoint-dir
           hostPath:
             path: /var/lib/kubelet/pods
             type: Directory
         - name: plugin-dir
           hostPath:
             path: /var/lib/kubelet/plugins/cifs.csi.k8s.io
             type: DirectoryOrCreate
   

2. 创建StorageClass
   定义使用CIFS插件的StorageClass：

   yaml
   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: cifs-sc
   provisioner: cifs.csi.k8s.io  # 插件provisioner名称
   parameters:
     server: "smb-server.example.com"  # CIFS服务器地址
     share: "data-share"              # 共享目录名称
     username: "smb-user"              # 访问用户名
     password: "smb-password"          # 访问密码
     mountOptions: "vers=3.0,sec=ntlmssp"  # 挂载选项（协议版本、安全模式等）
   reclaimPolicy: Delete  # 卷回收策略（Delete/Retain）
   

3. 创建PersistentVolumeClaim
   通过PVC请求CIFS存储卷：

   yaml
   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: cifs-pvc
   spec:
     accessModes:
       - ReadWriteMany  # CIFS支持多节点读写
     storageClassName: cifs-sc
     resources:
       requests:
         storage: 10Gi  # 请求存储容量（实际受共享目录限制）
   

4. 在Pod中使用存储卷
   将PVC挂载到Pod：

   yaml
   apiVersion: v1
   kind: Pod
   metadata:
     name: cifs-test-pod
   spec:
     containers:
     - name: test-container
       image: busybox
       command: ["sh", "-c", "while true; do echo Hello > /data/test.txt; sleep 10; done"]
       volumeMounts:
       - name: cifs-volume
         mountPath: /data
     volumes:
     - name: cifs-volume
       persistentVolumeClaim:
         claimName: cifs-pvc
   

配置参数说明

注意事项

• 确保所有节点均支持对应架构的镜像（amd64/arm/arm64）
• 敏感凭证（如password）建议通过Kubernetes Secret管理，避免明文配置
• 根据CIFS服务器配置调整mountOptions中的协议版本（vers=1.0/2.0/3.0/3.1.1）和安全模式（sec=ntlm/ntlmssp/etc）
• 多节点同时挂载时需确保CIFS服务器支持并发访问