jmgao1983/nfs-client-provisioner

nfs-client-provisioner 镜像文档

概述

nfs-client-provisioner是一个Kubernetes外部存储供应器，用于提供基于NFS（网络文件系统）的动态存储卷。它允许Kubernetes集群自动创建、配置和管理NFS存储卷，为Pod提供持久化存储解决方案。

核心功能和特性

• 动态供应NFS存储卷，无需手动创建PV（Persistent Volume）
• 支持StorageClass配置，实现不同存储策略
• 自动回收不再使用的存储卷
• 支持访问模式配置（ReadWriteOnce, ReadOnlyMany, ReadWriteMany）
• 可配置存储卷大小和访问权限

使用场景和适用范围

• Kubernetes集群需要持久化存储的应用部署
• 需要共享存储的多Pod应用
• 开发和测试环境的动态存储需求
• 需要简化存储管理的Kubernetes环境

使用方法和配置说明

前提条件

• 已部署的Kubernetes集群
• 可访问的NFS服务器
• 集群节点已安装NFS客户端工具

部署示例

使用kubectl部署

yaml
apiVersion: v1
kind: ServiceAccount
metadata:
  name: nfs-client-provisioner
  namespace: default
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: nfs-client-provisioner-runner
rules:
  - apiGroups: [""]
    resources: ["persistentvolumes"]
    verbs: ["get", "list", "watch", "create", "delete"]
  - apiGroups: [""]
    resources: ["persistentvolumeclaims"]
    verbs: ["get", "list", "watch", "update"]
  - 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-client-provisioner
subjects:
  - kind: ServiceAccount
    name: nfs-client-provisioner
    namespace: default
roleRef:
  kind: ClusterRole
  name: nfs-client-provisioner-runner
  apiGroup: rbac.authorization.k8s.io
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nfs-client-provisioner
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nfs-client-provisioner
  strategy:
    type: Recreate
  template:
    metadata:
      labels:
        app: nfs-client-provisioner
    spec:
      serviceAccountName: nfs-client-provisioner
      containers:
        - name: nfs-client-provisioner
          image: quay.io/external_storage/nfs-client-provisioner:latest
          volumeMounts:
            - name: nfs-client-root
              mountPath: /persistentvolumes
          env:
            - name: PROVISIONER_NAME
              value: example.com/nfs
            - name: NFS_SERVER
              value: 10.10.10.10  # 替换为您的NFS服务器IP
            - name: NFS_PATH
              value: /exported/path  # 替换为NFS服务器上的共享路径
      volumes:
        - name: nfs-client-root
          nfs:
            server: 10.10.10.10  # 替换为您的NFS服务器IP
            path: /exported/path  # 替换为NFS服务器上的共享路径
---
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: nfs-client
provisioner: example.com/nfs
parameters:
  archiveOnDelete: "false"

使用以下命令部署：

bash
kubectl apply -f deployment.yaml

环境变量配置

StorageClass参数

使用示例

创建PVC使用nfs-client存储类：

yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: test-nfs-pvc
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: nfs-client
  resources:
    requests:
      storage: 1Gi

在Pod中使用PVC：

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

注意事项

• 确保NFS服务器与Kubernetes集群之间网络通畅
• NFS服务器上的共享目录需要正确配置权限
• 建议为nfs-client-provisioner创建专用的命名空间
• 在生产环境中考虑部署多个副本以提高可用性
• 定期备份NFS服务器上的数据以防止数据丢失