dyrnq/nfsplugin

NFS存储插件镜像（registry.k8s.io/sig-storage/nfsplugin）

镜像概述

registry.k8s.io/sig-storage/nfsplugin是由Kubernetes SIG Storage（存储特别兴趣小组）维护的官方NFS存储插件镜像。该镜像实现了Kubernetes容器存储接口（CSI）规范，用于在Kubernetes集群中管理NFS（网络文件系统）类型的持久卷（Persistent Volume, PV），提供NFS存储与Kubernetes生态的无缝集成能力。

核心功能与特性

核心功能

• 持久卷生命周期管理：支持NFS持久卷的创建、挂载、卸载、删除等全生命周期操作
• 多协议支持：兼容NFSv3和NFSv4协议，适配不同版本的NFS服务器
• CSI规范实现：遵循Kubernetes CSI标准，支持与Kubernetes存储框架（如StorageClass、PVC）集成
• 动态/静态供应：支持通过StorageClass实现动态持久卷供应，也支持手动创建静态持久卷

关键特性

• 跨节点共享：支持跨Kubernetes节点的存储共享，满足分布式应用的数据共享需求
• 轻量级设计：镜像体积小，资源占用低，适合大规模集群部署
• 高兼容性：兼容主流Linux发行版的Kubernetes节点，支持x86_64、arm64等多种架构
• 自动化运维：支持卷挂载状态监控、异常恢复等自动化运维能力

使用场景与适用范围

典型使用场景

• 应用数据持久化：为需要数据持久化的Kubernetes应用（如数据库、文件服务）提供存储支持
• 共享存储需求：满足多副本应用（如分布式服务、日志聚合服务）的共享存储需求
• 低成本存储方案：作为低成本、易部署的网络存储方案，适用于非高性能要求的业务场景
• 现有NFS资源利用：将已有的NFS存储资源接入Kubernetes集群，实现存量存储资源的复用

适用范围

• Kubernetes集群版本：v1.18+（需与CSI规范版本匹配）
• NFS服务器：支持NFSv3/NFSv4协议的标准NFS服务器（如Linux NFS服务、NetApp、QNAP等设备）
• 节点环境：已安装NFS客户端工具（如nfs-common或nfs-utils）的Linux节点

使用方法与配置说明

部署方式

该插件通常以DaemonSet方式部署在Kubernetes集群的所有节点或指定节点上，确保每个节点均可处理NFS卷操作。典型部署流程如下：

1. 准备RBAC权限配置

yaml
# rbac.yaml
apiVersion: v1
kind: ServiceAccount
metadata:
  name: nfs-provisioner
  namespace: kube-system
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: nfs-provisioner-runner
rules:
- apiGroups: [""]
  resources: ["persistentvolumes"]
  verbs: ["get", "list", "watch", "create", "delete"]
- apiGroups: [""]
  resources: ["persistentvolumeclaims"]
  verbs: ["get", "list", "watch"]
- apiGroups: ["storage.k8s.io"]
  resources: ["storageclasses"]
  verbs: ["get", "list", "watch"]
- apiGroups: [""]
  resources: ["events"]
  verbs: ["create", "update", "patch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: run-nfs-provisioner
subjects:
- kind: ServiceAccount
  name: nfs-provisioner
  namespace: kube-system
roleRef:
  kind: ClusterRole
  name: nfs-provisioner-runner
  apiGroup: rbac.authorization.k8s.io

2. 部署DaemonSet

yaml
# daemon-set.yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: nfs-plugin
  namespace: kube-system
spec:
  selector:
    matchLabels:
      app: nfs-plugin
  template:
    metadata:
      labels:
        app: nfs-plugin
    spec:
      serviceAccountName: nfs-provisioner
      containers:
      - name: nfs-plugin
        image: registry.k8s.io/sig-storage/nfsplugin:latest
        args:
        - --v=2
        - --csi-address=/csi/csi.sock
        volumeMounts:
        - name: csi-socket-dir
          mountPath: /csi
        - name: nfs-client-root
          mountPath: /var/lib/kubelet/pods
          mountPropagation: Bidirectional
      volumes:
      - name: csi-socket-dir
        hostPath:
          path: /var/lib/kubelet/plugins/nfs.csi.k8s.io
          type: DirectoryOrCreate
      - name: nfs-client-root
        hostPath:
          path: /var/lib/kubelet/pods
          type: Directory

核心配置参数

环境变量配置

命令行参数

存储配置示例

1. 静态持久卷（PV）配置

yaml
# static-pv.yaml
apiVersion: v1
kind: PersistentVolume
metadata:
  name: nfs-static-pv
spec:
  capacity:
    storage: 10Gi
  accessModes:
    - ReadWriteMany
  persistentVolumeReclaimPolicy: Retain
  csi:
    driver: nfs.csi.k8s.io
    volumeHandle: nfs-static-pv-001  # 唯一标识，建议使用UUID
    volumeAttributes:
      server: 192.168.1.100  # NFS服务器地址
      share: /data/nfs-share  # NFS共享路径
      vers: "4"  # NFS协议版本
      mountOptions: "sec=sys,rw"  # 挂载选项

2. 动态供应配置（StorageClass）

yaml
# storageclass.yaml
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: nfs-sc
provisioner: nfs.csi.k8s.io
parameters:
  server: 192.168.1.100  # NFS服务器地址
  share: /data/nfs-root  # NFS共享根路径
  vers: "3"  # NFS协议版本
  mountOptions: "vers=3,soft"  # 全局挂载选项
reclaimPolicy: Delete  # 卷回收策略（Delete/Retain）
volumeBindingMode: Immediate  # 卷绑定模式
allowVolumeExpansion: false  # 是否支持卷扩容

3. 持久卷声明（PVC）配置

yaml
# pvc.yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: nfs-pvc
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 5Gi
  storageClassName: nfs-sc  # 关联上述StorageClass

注意事项

1. 节点依赖：确保所有Kubernetes节点已安装NFS客户端工具（Debian/Ubuntu：nfs-common；RHEL/CentOS：nfs-utils），否则会导致挂载失败

2. 网络互通：NFS服务器需与Kubernetes节点网络互通，且防火墙需开放NFS服务端口（NFSv3：111、2049、随机端口；NFSv4：2049）

3. 权限配置：NFS服务器共享目录需配置适当权限（如no_root_squash或指定用户ID），避免Pod挂载后权限不足

4. 版本匹配：镜像版本需与Kubernetes集群版本匹配（建议使用与集群版本相同的插件版本，如Kubernetes v1.24对应插件v4.0+）

5. 数据安全：NFS存储本身不提供数据冗余能力，生产环境建议结合NFS服务器的RAID或备份策略保障数据安全