文档中心

容器服务

NFS 访问方式

通过 NFS 使用 NAS 动态存储卷

本文介绍如何创建文件存储类型存储卷和存储卷声明，以及工作负载如何使用文件存储动态存储卷。

前提条件

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

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

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

使用限制

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

通过控制台配置

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

登录容器服务控制台。

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

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

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

配置项	说明
名称	根据系统提示自定义存储类名称，需确保存储类名称在集群内唯一。
存储类型	选择存储类型，本场景选择文件存储 NAS。
可用区	可用区是同一地域下电力、网络隔离的物理区域，可用区之间内网互通，不同可用区之间物理隔离。
计费类型	按需选择资源计费类型，目前支持按量计费。
文件系统类型	按需选择文件存储的文件系统类型。极速型：适用于 Linux 时延敏感型应用，例如：中小场景 AI、文件共享、Devops 代码存储。容量型：用于存储频繁访问的热数据，例如：数据库备份、日志存储、主目录等通用类文件共享业务。缓存型：【邀测】适用于工作负载使用高速文件系统接口进行数据访问场景，例如：机器学习、高性能计算（HPC）等。说明缓存型文件存储在容器服务属于邀测功能但无需额外申请权限；在文件存储 NAS 产品属于邀测特性。若需要使用此功能，需获取文件存储 NAS 的邀测使用权限。
项目	为存储类指定所属项目，从项目纬度管理集群资源的运维、授权等操作。默认选择 default（默认项目）。详情请参见项目管理。
挂载点	选择已有 NAS 文件系统下存在的挂载点。
子目录	根据系统提示的输入规则，输入待挂载的文件系统的子目录信息。默认为根目录为/。说明需要保证将要挂载的子目录在 NFS 中已经存在。
NFS 版本	选择所创建存储卷的网络文件系统（Network File System）版本，请按实际需求选择使用。若文件系统类型为极速型，仅支持 NFSv3 版本。若文件系统类型为容量型，仅支持 NFSv3 版本。若文件系统类型为缓存型，仅支持 NFSv4.1 版本。
回收策略	回收策略，包括： Delete：删除 PVC 的时候，需配合删除策略一起使用。当删除策略为延迟删除时，PV 和 NAS 文件数据将存档，不会被删除。当删除策略为立即删除时，PV 和 NAS 文件数据会被真正删除。 Retain：删除 PVC 的时候，PV 和 NAS 文件数据不会被删除，需要您手动删除。说明如果数据安全性要求高，推荐使用 Retain 方式以免误删数据。
存储卷模式绑定	绑定模式。包括： Immediate：随存储卷声明的创建直接完成卷的绑定和分配。 WaitForFirstConsumer：延迟存储卷的绑定和分配，直到使用该存储卷声明的 Pod 被创建。

单击确定，完成配置。

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

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

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

配置项	说明
命名空间	选择存储卷声明所属的命名空间。建议选择您自定义的命名空间，或系统默认创建的 default 命名空间。命名空间相关介绍，请参见命名空间概述。
名称	根据系统提示自定义存储卷声明的名称，需确保存储卷声明名称在集群内唯一。
存储类型	选择存储类型，本场景选择文件存储 NAS。
访问模式	选择存储卷声明的访问方式，目前支持 ReadWriteMany ，此访问方式支持多点读写。
计费类型	按需选择资源计费类型，目前支持按量计费。
文件系统类型	选择文件存储的文件系统类型，要求与存储类中配置的文件系统类型保持一致。极速型：适用于 Linux 时延敏感型应用，例如：中小场景 AI、文件共享、Devops 代码存储。容量型：用于存储频繁访问的热数据，例如：数据库备份、日志存储、主目录等通用类文件共享业务。缓存型：【邀测】适用于工作负载使用高速文件系统接口进行数据访问场景，例如：机器学习、高性能计算（HPC）等。说明缓存型文件存储在容器服务属于邀测功能但无需额外申请权限；在文件存储 NAS 产品属于邀测特性。若需要使用此功能，需获取文件存储 NAS 的邀测使用权限。
创建方式	存储卷声明的创建方式，包括：基于存储类创建、使用已有存储卷。本场景选择基于存储类创建。
存储类	自动绑定具有相同存储类，且容量大于或等于当前 PVC 设置的容量大小的存储卷。
容量	配置存储卷容量。说明该字段为 Kubernetes 必填字段，但此处设置的容量值不会限制应用实际使用量，实际容量仅跟文件系统容量有关。

单击确定，完成配置。

说明

系统按照 PVC 中的资源声明动态创建 PV 时，会在已关联的 NAS 挂载点下创建一个子目录。后续 Pod 使用该 PV 时会挂载该子目录。

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

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

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

通过 kubectl 命令行配置

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

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

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: vke-nas-sc # 存储类名称
provisioner: nas.csi.volcengine.com # 必填，存储挂载依赖的驱动，本示例为 nas.csi.volcengine.com，表示 csi-nas 插件
parameters:
fsType: Extreme # 必填，文件系统类型，取值：Extreme（极速型），Cache（缓存型），Capacity（容量型）
fsId: enas-cnbj1b9f32****** # 选填，NAS 文件系统 ID。仅 fsType 为 Extreme 时需配置此参数，使用其他文件系统类型时必须留空或不做配置
volumeAs: subpath # 必填，创建的子目录类型。取值：subpath（子路径）
server: cnshbb***.3qda7dut***.nas.ivolces.com # 必填，创建子路径类型的 PV 时，NAS 文件系统的挂载点域名地址
subPath: /tmp # 必填，NAS 挂载后的子目录，csi-nas 将在这个子目录中创建目录作为动态卷的后端存储
archiveOnDelete: "true" # 必填，存储卷删除策略，取值：true（延迟删除，PV 和 NAS 文件数据将存档，不会被删除），false（立即删除，PV 和 NAS 文件数据会被真正删除）
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 插件。
archiveOnDelete	存储卷是否与存储声明同步删除，包括： true：延迟删除，即当存储卷声明被删除时，NAS 文件数据不会被同步删除。 false：立即删除，即当存储卷声明被删除时，NAS 文件数据会被同步删除。
fsId	已创建的 NFS 文件系统 ID。说明您可以在文件存储控制台，查看已创建的文件系统 ID。详情请参见查看文件系统。
fsType	已创建的 NFS 文件系统类型，包括：Extreme（极速型），Cache（缓存型），Capacity（容量型）。说明 NFS 文件系统类型的说明，请参见产品简介。
volumeAs	指定 NFS 存储的子目录类型，取值：subpath（子路径）。
server	NAS 文件系统挂载点域名地址。说明当volumeAs配置为subpath，即在已存在文件系统下，创建子路径时，需要配置。
subpath	NAS 挂载后的子目录，系统将在这个子目录中创建目录作为动态卷的后端存储。
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-nas-sc.yaml

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

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

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

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

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

执行以下命令，创建 PVC。

kubectl create -f vke-nas-pvc.yaml

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

kubectl get pvc

预期输出结果如下：

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

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

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

说明

如果有使用弹性容器实例 VCI 的需求，需要在spec.template.metadata.annotations中添加 vke.volcengine.com/burst-to-vci: enforce。VCI 具备全托管免运维、按需付费、沙箱容器安全隔离等优势。详细介绍，请参见什么是弹性容器实例。

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

执行以下命令，创建 Deployment。

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

结果验证

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

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

kubectl exec dynamic-nas-deploy-5fcd*** -- df | grep tmp

预期返回结果如下。

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

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

kubectl exec dynamic-nas-deploy-5fcd*** -- ls /tmp

预期返回结果如下。

lost+found

在存储卷中写入文件。

kubectl exec dynamic-nas-deploy-5fcd*** -- touch /tmp/test

删除 Pod。

kubectl delete pod dynamic-nas-deploy-5fcd***

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

kubectl exec dynamic-nas-deploy-5fcd*** -- ls /tmp

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

lost+found
test