文档中心

容器服务

NFS 访问方式

通过 NFS 使用 EFS 动态存储卷

本文介绍如何使用协议服务 NFS 创建 EFS 存储类和存储卷声明，以及工作负载如何使用 EFS 动态存储卷。

前提条件

已安装 csi-nas 组件。详情请参见 csi-nas。

已创建 EFS 文件系统和挂载点，详情请参见创建文件系统、管理挂载点。

（可选）已在本地安装 kubectl 工具，并通过 kubectl 连接目标集群。详情请参见连接集群。

使用限制

有状态负载需要独占一个卷，暂不支持使用手动创建的存储卷声明。

通过控制台配置

步骤一：创建存储类（StorageClass）

登录容器服务控制台。

在左侧导航栏中，选择集群。单击目标集群名称，进入集群管理页面。

在集群管理页面左侧导航栏中，选择存储管理 > 存储类。

单击创建存储类，在弹出的配置页面中，完成参数配置。

配置项	说明
名称	根据系统提示自定义存储类名称，需确保存储类名称在集群内唯一。
存储类型	选择存储类型，本场景选择弹性文件存储。
访问类型	存储卷的访问类型，本场景选择 NFS。
可用区	可用区是同一地域下电力、网络隔离的物理区域，可用区之间内网互通，不同可用区之间物理隔离。
计费类型	按需选择资源计费类型，目前支持按量计费。
项目	为存储类指定所属项目，从项目维度管理集群资源的运维、授权等操作。默认选择 default（默认项目）。详情请参见项目管理。
挂载点	选择已创建的 EFS 文件系统和挂载点。
子目录	根据系统提示的输入规则，输入待挂载的文件系统的子目录信息。默认为根目录为/。说明需要保证将要挂载的子目录在 NFS 中已经存在。
NFS 版本	选择所创建存储卷的网络文件系统（Network File System）版本，支持 NFSv3 和 NFSv4.1 版本。
回收策略	存储卷回收策略，包括： Delete：删除 PVC 的时候，需配合删除策略一起使用。当删除策略为延迟删除时，PV 和 EFS 文件数据将存档，不会被删除。当删除策略为立即删除时，PV 和 EFS 文件数据会被真正删除。 Retain：删除 PVC 的时候，PV 和 EFS 文件数据不会被删除，需要您手动删除。说明如果数据安全性要求高，推荐使用 Retain 方式以免误删数据。
存储卷模式绑定	存储卷绑定模式。包括： Immediate：随存储卷声明的创建直接完成卷的绑定和分配。 WaitForFirstConsumer：延迟存储卷的绑定和分配，直到使用该存储卷声明的 Pod 被创建。

单击确定，完成配置。

步骤二：创建存储卷声明（PVC）

在集群管理页面左侧导航栏中，选择存储管理 > 存储卷声明。

单击创建存储卷声明，在弹出的配置页面中，完成参数配置。

配置项	说明
命名空间	选择存储卷声明所属的命名空间。建议选择您自定义的命名空间，或系统默认创建的 default 命名空间。命名空间相关介绍，请参见命名空间概述。
名称	根据系统提示自定义存储卷声明的名称，需确保存储卷声明名称在集群内唯一。
存储类型	选择存储类型，本场景选择弹性文件存储。
访问模式	选择存储卷声明的访问方式，目前支持 ReadWriteMany ，此访问方式支持多点读写。
计费类型	按需选择资源计费类型，目前支持按量计费。
创建方式	存储卷声明的创建方式，本场景选择基于存储类创建。
存储类	自动绑定具有相同存储类，且容量大于或等于当前 PVC 设置的容量大小的存储卷。
容量	配置存储卷容量，单位为 Gi，取值范围为 1～10485760。说明该配置为 Kubernetes 必配字段，但此处设置的容量值不会限制应用实际使用量，实际容量仅跟文件系统容量有关。

单击确定，完成配置。

步骤三：创建应用并挂载存储卷

文件存储类型的动态存储卷创建完成后，可通过添加卷的方式挂载到工作负载使用，包括：无状态负载、有状态负载、任务、定时任务、守护进程。

可通过创建工作负载或更新工作负载操作的容器配置步骤，为工作负载添加卷并挂载卷。详细操作，请参见工作负载。

通过 kubectl 命令行配置

步骤一：创建存储类（StorageClass）

创建 StorageClass 的 YAML 文件。示例文件vke-efs-sc.yaml代码如下：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: vke-efs-sc # 存储类名称
provisioner: nas.csi.volcengine.com # 必填，存储挂载依赖的驱动，本示例为 nas.csi.volcengine.com，表示 csi-nas 插件
parameters:
fsType: efs # 必填，文件系统类型，取值为 efs
volumeAs: subpath # 必填，创建的子目录类型。取值：subpath（子路径），filesystem（文件系统）
server: cnbja5ef96***.3pspvsoy8hyps6c***.efs.ivolces.com # 必填，创建子路径类型的 PV 时，EFS 文件系统的挂载点域名地址
subPath: / # 必填，EFS 挂载后的子目录，csi-nas 将在这个子目录中创建目录作为动态卷的后端存储
archiveOnDelete: "true" # 必填，存储卷删除策略，取值：true（延迟删除，PV 和 EFS 文件数据将存档，不会被删除），false（立即删除，PV 和 EFS 文件数据会被真正删除）
mountOptions:
- nolock,proto=tcp,noresvport
- vers=3 # 挂载数据卷的协议版本号。取值：3（NFSv3）、4.1（NFSv4.1）
reclaimPolicy: Delete # 存储卷回收策略。取值：Retain（保留策略），Delete（删除策略）
volumeBindingMode: Immediate # 存储卷绑定模式，取值：Immediate（立即绑定和分配），WaitForFirstConsumer（延迟存储卷的绑定和分配）

关键参数说明，如下表所示。

参数	说明
provisioner	存储卷挂载依赖的驱动，本文中需要配置为nas.csi.volcengine.com，表示 csi-nas 插件。
fsType	文件系统类型，本文中取值为efs，表示使用弹性文件存储。
volumeAs	指定 EFS 存储的子目录类型，包括： subpath：在已存在文件系统下，创建子路径。 filesystem：创建一个新的文件系统。
server	EFS 文件系统中，已创建的挂载点域名地址。说明当volumeAs配置为subpath，即在已存在文件系统下，创建子路径时，需要配置。
subPath	EFS 挂载后的子目录，系统将在这个子目录中创建目录作为动态卷的后端存储。
archiveOnDelete	存储卷是否与存储声明同步删除，包括： true：延迟删除，即当存储卷声明被删除时，EFS 文件数据不会被同步删除。 false：立即删除，即当存储卷声明被删除时，EFS 文件数据会被同步删除。
volumeHandle	存储卷唯一标识符，与存储卷（PV）的名称保持一致即可。
mountOptions	存储卷挂载参数，支持动态修改，仅对新挂载的存储卷生效，对已挂载的存储卷不生效。其中，允许使用vers 参数指定挂载存储卷的 NFS 协议版本号。取值： 3：表示 NFSv3 4.1：表示 NFSv4.1
reclaimPolicy	存储卷回收策略。取值： Delete：删除 PVC 时，会同步删除 PV 以及 PV 中的数据。 Retain：删除 PVC 时，不会同步删除 PV 以及 PV 中的数据，需要您手动删除。注意如果数据安全性要求高，推荐使用 Retain 方式以免误删数据。选择 Delete 回收策略时，删除的数据不可恢复，请根据实际情况谨慎选择。
volumeBindingMode	存储卷的绑定模式。取值： Immediate：随存储卷声明的创建直接完成卷的绑定和分配。 WaitForFirstConsumer：延迟存储卷的绑定和分配，直到使用该存储卷声明的 Pod 被创建。

执行以下命令，创建 StorageClass。

kubectl create -f vke-efs-sc.yaml

步骤二：创建存储卷声明（PVC）

创建 PVC 的 YAML 文件。示例文件vke-efs-pvc.yaml代码如下：

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: vke-efs-pvc # 存储卷声明名称
namespace: default # 存储卷声明所属命名空间
spec:
accessModes: # 存储卷声明访问模式。目前仅支持 ReadWriteMany，表示多点读写
- ReadWriteMany
resources:
requests:
storage: 100Gi # 声明的存储使用量，单位为 Gi
storageClassName: vke-efs-sc # 已创建的存储类名称
volumeMode: Filesystem # 存储卷类型，取值：Filesystem（将存储卷作为文件系统使用）、Block（将存储卷作为块设备使用）

关键参数说明，如下表所示。

参数	说明
accessModes	存储卷声明的访问方式，仅支持 ReadWriteMany，表示多点读写。
storage	存储卷容量，单位为 Gi，整数形式，取值范围为 1～1~10485760。说明该字段为 Kubernetes 必填字段，但此处设置的容量值不会限制应用实际使用量，实际容量仅跟文件系统容量有关。
storageClassName	已创建的存储类名称。
volumeMode	存储卷类型，包括： Filesystem：（默认值）将存储卷作为文件系统使用。存储卷会被格式化并挂载一个文件系统（如 ext4、xfs），再将该文件系统挂载到容器指定路径。您可以在容器中使用ls命令（例如ls /data）能查看挂载的目录或文件，并可以直接读写文件。 Block：将卷作为块设备使用。直接暴露给容器，不格式化、不挂载文件系统。您可以通过/dev/block/xxx 类似的路径操作块设备，应用需支持裸块设备读写。

执行以下命令，创建 PVC。

kubectl create -f vke-efs-pvc.yaml

执行以下命令，查看 PVC 声明的动态卷是否创建成功。

kubectl get pvc

预期输出结果如下：

NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE
vke-efs-pvc Bound pvc-6318***-3d355a768220 100Gi RWX vke-efs-sc 5s

步骤三：创建应用并挂载存储卷

创建 Deployment 的 YAML 文件。示例文件vke-dynamic-efs-deployment.yaml代码如下：

apiVersion: apps/v1
kind: Deployment
metadata:
name: dynamic-efs-deploy
spec:
replicas: 1
selector:
matchLabels:
app: dynamic-efs-deploy
template:
metadata:
labels:
app: dynamic-efs-deploy
spec:
containers:
- image: doc-cn-beijing.cr.volces.com/vke/nginx-demo:v1.0
name: nginx
volumeMounts:
- mountPath: /tmp # EFS 在容器中挂载的位置
name: efs-pv
volumes:
- name: efs-pv
persistentVolumeClaim:
claimName: vke-efs-pvc # 已创建的 PVC 名称

执行以下命令，创建 Deployment。

kubectl create -f vke-dynamic-efs-deployment.yaml

结果验证

按照上文示例创建工作负载并挂载存储卷后，您可以通过以下方式验证存储卷的挂载和持久化存储。

执行以下命令，查看存储卷是否正确挂载到 Pod 的指定路径。

kubectl exec dynamic-efs-deploy-665769f*** -- df | grep tmp

预期返回结果如下。

cnshb***.3qda7dut***.efs.ivolces.com:/tmp/pvc-6318d*** 10995116277760 0 10995116277760 0% /tmp

查看 Pod 中的挂载路径，即查看存储卷中的数据。

kubectl exec dynamic-efs-deploy-665769f*** -- ls /tmp

预期返回结果如下。

lost+found

在存储卷中写入文件。

kubectl exec dynamic-efs-deploy-665769f*** -- touch /tmp/test

删除 Pod。

kubectl delete pod dynamic-efs-deploy-665769f***

查看新创建 Pod 下的存储卷挂载路径。

kubectl exec dynamic-efs-deploy-665769f*** -- ls /tmp

预期返回如下，可以看到存储卷中写入的文件依然存在，未随着 Pod 的删除而被删除，实现了数据的持久化存储。

lost+found
test