使用 NAS 文件存储动态存储卷

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

前提条件

• 已创建容器服务集群。操作方法，请参见 创建集群。
• 确保当前集群已安装文件存储服务组件 csi-nas。操作方法，请参见 安装组件。

使用限制

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

通过控制台使用

使用文件存储类型动态存储卷的详细操作步骤和参数配置如下：

步骤一：登录集群管理页面

1. 登录 容器服务控制台。
2. 在容器服务的左侧导航栏，选择 集群。
3. 单击目标集群名称，进入集群管理页面。

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

1. 在集群管理页面，选择 存储管理 > 存储类。
2. 单击存储类列表左上角 创建存储类。
3. 在弹出的 创建存储类 页面，完成参数配置。其中，存储类型选择 文件存储。

4. 配置完成后，单击 确定，完成存储类创建。

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

1. 在集群管理页面，选择 存储管理 > 存储卷声明。
2. 单击存储卷列表左上角 创建存储卷声明。
3. 在弹出的 创建存储卷声明 页面，完成参数配置。其中，存储类型选择 文件存储。

4. 配置完成后，单击 确定，完成存储卷声明创建。

   说明

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

步骤四：工作负载添加卷

文件存储类型的动态存储卷创建完成后，可通过添加卷的方式挂载到工作负载使用，包括：无状态负载、任务、定时任务、守护进程。
可通过创建工作负载或更新工作负载操作的容器配置步骤，为工作负载添加卷并挂载卷。详细操作，请参见 工作负载。

通过 kubectl 命令行使用

准备工作

• 安装 kubectl 工具到本地。具体操作说明，请参见 安装和设置 kubectl。
• 连接目标集群。具体操作说明，请参见 连接集群。

步骤一：创建 StorageClass

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

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: vke-nas-sc  # StorageClass 名称。
   mountOptions:
   - nolock,proto=tcp,noresvport
   - vers=3   # 挂载 NAS 数据卷的 NFS 协议版本号。3 表示 NFSv3，极速型仅支持使用此版本；4.1 表示 NFSv4.1，通用型和缓存型仅支持使用此版本。
   parameters:
     ChargeType: PostPaid  # 计费类型，目前仅支持 PostPaid 按量计费。
     archiveOnDelete: "true"  # 删除策略，true：延迟删除，PV 和 NAS 文件数据将存档，不会被删除；false：立即删除，PV 和 NAS 文件数据会被真正删除。
     fsId: enas-cnbj1b9f32******  # NAS 文件系统 ID，仅当文件系统类型为极速型时需要配置。
     fsType: Extreme    # 文件系统类型，Extreme：极速型；Cache：缓存型；Common：通用型。
     server: cnbj1b9f32******.r*********.nas.ivolces.com  # 创建子目录类型的 PV 时，NAS 文件系统的挂载点地址。
     subPath: /sub  # 子目录路径。
     volumeAs: subpath  # 创建的子目录类型。subpath：子路径；filesystem：文件系统。
   provisioner: nas.csi.volcengine.com  # 驱动类型，本示例为 nas.csi.volcengine.com，表示火山引擎 csi-nas 插件。
   reclaimPolicy: Delete   # 回收策略，Delete：删除策略，与 archiveOnDelete 配合使用；Retain：保留策略，删除 PVC 时 PV 和关联的文件系统不会删除，需手动删除。
   volumeBindingMode: Immediate   # 卷绑定模式，Immediate：立即绑定和分配；WaitForFirstConsumer：延迟存储卷的绑定和分配。
   

2.执行以下命令，创建 StorageClass。

kubectl create -f vke-nas-sc.yaml

步骤二：创建 PVC

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

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: csi-nas-pvc   # PVC 名称。
  namespace: default
spec:
  accessModes:   # 访问模式，ReadWriteMany：多点读写。
  - ReadWriteMany
  resources:
    requests:
      storage: 20Gi   # 声明应用存储使用量。Kubernetes 必填字段，但此处设置的容量值不会限制应用实际使用量，实际容量仅跟文件系统容量有关。
  storageClassName: vke-nas-sc   # 步骤一中创建的 StorageClass 名称。

2. 执行以下命令，创建 PVC。

   kubectl create -f vke-nas-pvc.yaml
   

3. 执行以下命令，查看 PVC 与 StorageClass 的动态绑定结果。

   kubectl get pvc
   

   预期输出结果如下，表示 NAS 通过配置 StorageClass 完成了 PVC 与 PV 的动态绑定成功。

   NAME             STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   
   csi-nas-pvc      Bound    pvc-6e8c646b-e3e9-4d02-836e-3b66********   20Gi       RWX            vke-nas-sc      
   

步骤三：创建 Deployment

1. 创建 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: nginx
           imagePullPolicy: IfNotPresent
           name: nginx
           volumeMounts:
           - mountPath: /tmp # NAS 在容器中挂载的位置。
             name: nas-pv
         volumes:
         - name: nas-pv
           persistentVolumeClaim:
             claimName: vke-nas-pvc  # 步骤二中创建的 PVC 名称。
   
   

2. 执行以下命令，创建 Deployment。

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

相关文档

• 创建无状态负载
• 创建任务
• 创建定时任务
• 创建守护进程