NFS-子目录外部供应者(NFS-Subdir-External-Provisioner)安装与使用指南

目录结构及介绍

本指南将引导您理解并操作nfs-subdir-external-provisioner项目，这是一个用于Kubernetes环境下的存储供应器，能够基于现有的NFS服务器来创建动态的持久卷。

目录概览

在克隆或下载了该项目之后，您将看到如下的主要目录：

• deploy: 包含了用于部署供应器及其相关资源的所有YAML模板。
  • deployment.yaml: 供应器实例的部署定义。
  • test-*: 测试脚本和样例持久卷请求(PVC)以及Pod。
• charts: Helm图表用于在Kubernetes集群中以更简洁的方式部署供应器。
• docs: 文档和说明性文件。
• Makefile: 自动化构建、测试和打包任务的定义。
• main.go: 主应用程序代码。
• Dockerfile: Docker镜像的构建脚本。

启动文件介绍

部署前准备: 确保您的环境中已正确设置了Kubernetes集群并具有权限进行API调用。

部署步骤:

1. 编辑deploy/deployment.yaml中的容器图像位置以匹配您的NFS客户端供应器图像的位置。

   spec:
     containers:
       - name: nfs-client-provisioner
         image: YOUR_IMAGE_NAME
   

   其中YOUR_IMAGE_NAME应替换为您实际使用的图像名称。

2. 在deploy/deployment.yaml中指定NFS服务器详细信息。

   env:
     - name: NFS_SERVER
       value: YOUR_NFS_SERVER_HOSTNAME
     - name: NFS_PATH
       value: "/path/on/nfs/server"
   

   更新YOUR_NFS_SERVER_HOSTNAME和路径以反映您的环境。

3. 创建服务账号及相关策略:

   使用kubectl apply -f deploy/rbac.yaml来应用RBAC规则。

4. 最终通过运行kubectl apply -f deploy/deployment.yaml来启动供应器。

配置文件介绍

nfs-subdir-external-provisioner的关键配置在于其StorageClass的定义，它决定了如何从NFS服务器创建存储卷。

编辑StorageClass:

1. 打开deploy/storageclass.yaml文件。

2. 修改provisioner字段以匹配您在deployment.yaml中的PROVISIONER_NAME设定值。

   provisioner: k8s-sigs.io/nfs-subdir-external-provisioner
   

   这个字段应同deployment.yaml内的name一致。

3. 根据需求调整参数，例如onDelete行为决定PVC释放时是否删除对应的NFS子目录。

以上步骤构成了初始化和配置nfs-subdir-external-provisioner的主要流程，在熟悉这些基本操作后，您可以进一步探索高级特性与故障排查方法。

请注意始终检查官方文档以获取最新指导和兼容性注意事项，特别是当涉及到不同版本的Kubernetes与存储类定义时。