使用NAS动态存储卷

kubectl

1. 参见以下内容创建alicloud-nas-subpath.yaml。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     # StorageClass名称，需在集群内唯一
     name: alicloud-nas-subpath  
   mountOptions:
   - nolock,tcp,noresvport
   - vers=3
   parameters:
     # 设置为 subpath
     volumeAs: subpath
     # server 字段格式为 <nas-server-address>:/<path>
     server: "0cd8b4a576-g****.cn-hangzhou.nas.aliyuncs.com:/k8s"
     archiveOnDelete: "true"
   provisioner: nasplugin.csi.alibabacloud.com
   reclaimPolicy: Retain
   allowVolumeExpansion: true

   参数		描述
   mountOptions		NAS的挂载参数，包括NFS协议版本等。默认使用v3协议挂载，可通过vers=4.0方式指定协议版本。关于不同NAS类型支持的NFS协议，请参见NFS协议。
   parameters.volumeAs		挂载模式，设置为subpath。
   parameters.server		NAS挂载点地址及待挂载的子目录路径，格式为<nas-server-address>:/<path>。 <nas-server-address>：NAS文件系统的挂载点地址。可参见管理挂载点查看。 :/<path>：待挂载的NAS子目录。如未设置或指定的子目录不存在，则默认挂载到根目录。 通用型NAS：根目录为/。 极速型NAS：根目录为/share。挂载子目录时，path需以/share开头（如/share/data）。
   parameters.archiveOnDelete		删除PVC时，若reclaimPolicy为Delete，后端存储的文件数据是否被真正删除。 NAS为共享存储，提供此选项进行双重确认。 true（默认）：不会真正删除目录或文件，而是将其归档并重命名，格式为archived-{pvName}.{timestamp}。 false：后端对应的目录及数据会被真正删除。 此处删除的是NAS的subpath目录以及其中文件，NAS文件系统本身不会被删除。 如需删除NAS文件系统，请参见删除文件系统。 在高频创建和删除PV的场景下，设置为 false 可能导致CSI控制器任务队列阻塞，新PV无法被创建，请参见使用NAS动态存储卷时Controller的任务队列已满且无法创建新的PV。
   provisioner		驱动类型。使用阿里云NAS CSI组件时固定为nasplugin.csi.alibabacloud.com。
   reclaimPolicy		PV的回收策略。 Delete（默认）：删除PVC时，根据archiveOnDelete的配置处理后端存储数据。 Retain：删除PVC时，PV和NAS文件不会被删除，需手动删除。适用于对数据安全性要求高的场景，以免误删数据。
   allowVolumeExpansion		仅通用型NAS支持 允许通过修改 PVC 容量来动态扩容由该 StorageClass 创建的 PV。 该 StorageClass 将基于 NAS 的目录配额功能来管理PV容量，从而精确地管理和限制其容量。支持通过编辑 PVC 的 spec.resources.requests.storage 字段来实现在线扩容，请参见为NAS动态存储卷设置目录配额。 NAS 目录配额的生效是一个异步过程。PV 刚刚创建或扩容完成后，如果立即进行高速、大批量的数据写入，存在因配额尚未完全生效而超出规定容量的可能。请参见使用限制了解更多使用限制。

2. 创建StorageClass。

   kubectl create -f alicloud-nas-subpath.yaml

控制台

1. 登录容器服务管理控制台，在左侧导航栏选择集群列表。

2. 在集群列表页面，单击目标集群名称，然后在左侧导航栏，选择存储 > 存储类。

3. 单击创建，配置StorageClass名称（集群内保持唯一）并选择存储卷类型为NAS，按照页面提示完成StorageClass的创建。

   主要配置项如下。

   配置项	说明
   选择挂载点	NAS文件系统的挂载点地址。
   存储卷模式	存储卷访问模式。本示例为子目录，即subpath，将在挂载路径下自动创建子目录。数据将存储于<NAS挂载点>:<挂载路径>/<pv-name>/下。
   挂载路径	待挂载的NAS子目录。如果未设置，则默认挂载到根目录。 如果NAS中没有该目录，系统会自动创建并进行挂载。 通用型NAS：根目录为/。 极速型NAS：根目录为/share。挂载子目录时，path需以/share开头（如/share/data）。
   回收策略	PV的回收策略。 Delete（默认）：删除PVC时，根据archiveOnDelete的配置处理后端存储数据。 Retain：删除PVC时，PV和NAS文件不会被删除，需手动删除。适用于对数据安全性要求高的场景，以免误删数据。
   挂载选项	NAS的挂载参数，包括NFS协议版本等。默认使用v3协议挂载，可通过vers=4.0方式指定协议版本。关于不同NAS类型支持的NFS协议，请参见NFS协议。

   创建后，可在存储类列表查看创建的StorageClass。

kubectl

1. 参见以下内容创建nas-pvc.yaml。

   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata: 
     name: nas-csi-pvc
   spec:
     accessModes:
     - ReadWriteMany 
     # 指定待绑定的 StorageClass
     storageClassName: alicloud-nas-subpath  
     resources: 
       requests:
         # 声明所需使用的存储卷的容量
         storage: 20Gi  

   参数	说明
   accessModes	访问模式。可取值： ReadWriteMany（默认）：多节点读写。 ReadWriteOnce：单节点读写。 ReadOnlyMany：多节点只读。
   storageClassName	待绑定的StorageClass。
   storage	声明所需使用的存储卷的容量。默认情况下，此声明主要作为资源请求，并不限制Pod实际可用的存储空间。 NAS容量上限由规格决定，请参见通用型NAS和极速型NAS确认。 但当StorageClass的allowVolumeExpansion为true时，此值将变为一个严格执行的硬性限制。CSI 将按照该配置设置NAS的目录配额，限制PV的可用容量。

2. 创建PVC。

   kubectl create -f nas-pvc.yaml

3. 查看PV。

   kubectl get pv

   预期输出如下，表明已基于StorageClass自动创建了PV，并绑定到PVC。

   NAME                                       CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM                 STORAGECLASS             VOLUMEATTRIBUTESCLASS   REASON   AGE
   nas-a7540d97-0f53-4e05-b7d9-557309******   20Gi       RWX            Retain           Bound    default/nas-csi-pvc   alicloud-nas-subpath     <unset>                          5m

控制台

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

2. 在存储声明页面，单击创建，配置PVC后，单击创建。

   配置项	说明
   存储声明类型	选择NAS。
   名称	PVC名称，在命名空间内保持唯一。
   分配模式	选择使用存储类动态创建。
   已有存储类	单击选择存储类，选择此前创建的StorageClass。
   总量	声明所需使用的存储卷的容量。默认情况下，此声明主要作为资源请求，并不限制Pod实际可用的存储空间。 NAS容量上限由规格决定，请参见通用型NAS和极速型NAS确认。 但当StorageClass的allowVolumeExpansion为true时，此值将变为一个严格执行的硬性限制。CSI 将按照该配置设置NAS的目录配额，限制PV的可用容量。
   访问模式	访问模式。可取值： ReadWriteMany（默认）：多节点读写。 ReadWriteOnce：单节点读写。 ReadOnlyMany：多节点只读。

kubectl

创建2个Deployment并挂载同一PVC，使其共享同一个NAS文件系统的同一个子目录。

如需为多个Pod挂载同一NAS文件系统的不同子目录，请按照子目录创建不同的StorageClass和对应的PVC，再分别挂载PVC。

1. 参见以下内容，分别创建nginx-1.yaml和nginx-2.yaml。

   两个应用的配置基本一致，两者引用同一PVC。

   • nginx-1.yaml

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: nas-test-1     
       labels:
         app: nginx
     spec:
       selector:
         matchLabels:
           app: nginx
       template:
         metadata:
           labels:
             app: nginx
         spec:
           containers:
           - name: nginx
             image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
             ports:
             - containerPort: 80
             volumeMounts:
               - name: nas-pvc
                 # NAS在容器中的挂载路径
                 mountPath: "/data"          
           volumes:
             - name: nas-pvc                 
               persistentVolumeClaim:
                 # 绑定此前创建的 PVC
                 claimName: nas-csi-pvc      

   • nginx-2.yaml

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: nas-test-2     
       labels:
         app: nginx
     spec:
       selector:
         matchLabels:
           app: nginx
       template:
         metadata:
           labels:
             app: nginx
         spec:
           containers:
           - name: nginx
             image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
             ports:
             - containerPort: 80
             volumeMounts:
               - name: nas-pvc
                 # NAS在容器中的挂载路径
                 mountPath: "/data"           
           volumes:
             - name: nas-pvc                 
               persistentVolumeClaim:
                 # 绑定此前创建的 PVC
                 claimName: nas-csi-pvc       

2. 创建2个Deployment。

   kubectl create -f nginx-1.yaml -f nginx-2.yaml

3. 查看Pod状态。

   kubectl get pod -l app=nginx

   预期输出

   NAME                         READY   STATUS    RESTARTS   AGE
   nas-test-1-b75d5b6bc-*****   1/1     Running   0          51s
   nas-test-2-b75d5b6bc-*****   1/1     Running   0          44s

4. 查看两个 Pod 详细配置，确认挂载的PVC。

   将<podName>替换为两个Pod的实际名称。

   kubectl describe pod <podName> | grep "ClaimName:"

   预期输出中，两个Pod挂载的PVC一致，共享NAS文件系统的同一子目录。

控制台

重复以下操作，分别创建2个Deployment并挂载同一PVC，使其共享同一个NAS文件系统的同一个子目录。

1. 在ACK集群列表页面，单击目标集群名称，在集群详情页左侧导航栏，选择工作负载 > 无状态。

2. 单击使用镜像创建，按照页面提示完成应用的配置和创建。

   主要参数如下，其他参数保持默认即可。详见创建无状态工作负载Deployment。

   配置项	参数	说明
   应用基本信息	副本数量	Deployment的副本数量。
   容器配置	镜像名称	用于部署应用的镜像地址。
   	所需资源	所需的vCPU和内存资源。
   	数据卷	单击增加云存储声明，然后完成参数配置。 挂载源：选择之前创建的PVC。 容器路径：输入NAS文件系统要挂载到的容器路径。

   部署完成后，可在无状态页面单击应用名称，在容器组页签下确认Pod已正常运行（状态为Running）。

kubectl

控制台

1. 在集群列表页面，单击目标集群名称，然后在左侧导航栏，选择存储 > 存储类。

2. 单击创建，配置StorageClass名称（集群内保持唯一）并选择存储卷类型为NAS，按照页面提示完成StorageClass的创建。

   配置项	说明
   选择挂载点	NAS文件系统的挂载点地址。
   存储卷模式	存储卷访问模式。本示例为共享目录，即sharepath。
   挂载路径	待挂载的NAS子目录。如果未设置，则默认挂载到根目录。 如果NAS中没有该目录，系统会自动创建并进行挂载。 通用型NAS：根目录为/。 极速型NAS：根目录为/share。挂载子目录时，path需以/share开头（如/share/data）。
   回收策略	使用sharepath时必须设置为 Retain。
   挂载选项	NAS的挂载参数，包括NFS协议版本等。默认使用v3协议挂载，可通过vers=4.0方式指定协议版本。关于不同NAS类型支持的NFS协议，请参见NFS协议。

kubectl

1. 创建命名空间ns1和ns2。

   kubectl create ns ns1
   kubectl create ns ns2

2. 参见以下内容创建pvc.yaml，分别在 ns1 和 ns2 命名空间下创建同名 PVC。

   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata: 
     name: nas-csi-pvc
     namespace: ns1
   spec:
     accessModes:
     - ReadWriteMany 
     storageClassName: alicloud-nas-sharepath
     resources: 
       requests:
         storage: 20Gi
   ---
   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata: 
     name: nas-csi-pvc
     namespace: ns2
   spec:
     accessModes:
     - ReadWriteMany 
     storageClassName: alicloud-nas-sharepath
     resources: 
       requests:
         storage: 20Gi

   参数	说明
   accessModes	访问模式。可取值： ReadWriteMany（默认）：多节点读写。 ReadWriteOnce：单节点读写。 ReadOnlyMany：多节点只读。
   storageClassName	待绑定的StorageClass。
   storage	声明所需使用的存储卷的容量。默认情况下，此声明主要作为资源请求，并不限制Pod实际可用的存储空间。 NAS容量上限由规格决定，请参见通用型NAS和极速型NAS确认。 但当StorageClass的allowVolumeExpansion为true时，此值将变为一个严格执行的硬性限制。CSI 将按照该配置设置NAS的目录配额，限制PV的可用容量。

3. 创建PVC。

   kubectl create -f pvc.yaml

4. 查看PV状态，确认已为 PVC 自动创建并绑定了对应的 PV。

   kubectl get pv

   预期输出如下，两个状态 PV 均为 Bound ， CLAIM 显示每个 PV 分别绑定到两个命名空间下的 PVC（ns1/nas-csi-pvc 和 ns2/nas-csi-pvc）。

   NAME                                       CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM                 STORAGECLASS             VOLUMEATTRIBUTESCLASS   REASON   AGE
   nas-0b448885-6226-4d22-8a5b-d0768c******   20Gi       RWX            Retain           Bound    ns1/nas-csi-pvc       alicloud-nas-sharepath   <unset>                          74s
   nas-bcd21c93-8219-4a11-986b-fd934a******   20Gi       RWX            Retain           Bound    ns2/nas-csi-pvc       alicloud-nas-sharepath   <unset>                          74s

控制台

1. 创建命名空间。

   • 在集群列表页面，单击目标集群名称，然后在左侧导航栏，选择命名空间与配额。

   • 单击创建，安装页面提示创建命名空间ns1和ns2。

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

3. 在命名空间ns1下，创建一个存储声明。

   在存储声明页面，选择命名空间为ns1，按照页面提示完成PVC的创建。

   配置项	说明
   存储声明类型	选择NAS。
   名称	PVC名称，在命名空间内保持唯一。
   分配模式	选择使用存储类动态创建。
   已有存储类	单击选择存储类，选择此前创建的StorageClass。
   总量	声明所需使用的存储卷的容量。默认情况下，此声明主要作为资源请求，并不限制Pod实际可用的存储空间。 NAS容量上限由规格决定，请参见通用型NAS和极速型NAS确认。 但当StorageClass的allowVolumeExpansion为true时，此值将变为一个严格执行的硬性限制。CSI 将按照该配置设置NAS的目录配额，限制PV的可用容量。
   访问模式	访问模式。可取值： ReadWriteMany（默认）：多节点读写。 ReadWriteOnce：单节点读写。 ReadOnlyMany：多节点只读。

4. 参见上一步，在命名空间ns2下，再次创建一个PVC。

   创建后，返回存储声明页面，在命名空间ns1和ns2下，确认2个PVC均已绑定自动创建的PV。

kubectl

1. 参见以下内容，分别创建nginx-ns1.yaml和nginx-ns2.yaml。

   2个应用的配置基本一致，分别绑定相应Namespace下的PVC。

   • nginx-ns1.yaml

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: nas-test
       namespace: ns1   
     spec:
       selector:
         matchLabels:
           app: nginx
       template:
         metadata:
           labels:
             app: nginx
         spec:
           containers:
           - name: nginx
             image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
             ports:
             - containerPort: 80
             volumeMounts:
               - name: nas-pvc
                 mountPath: "/data"
           volumes:
             - name: nas-pvc
               persistentVolumeClaim:
                 claimName: nas-csi-pvc

   • nginx-ns2.yaml

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: nas-test
       namespace: ns2   
     spec:
       selector:
         matchLabels:
           app: nginx
       template:
         metadata:
           labels:
             app: nginx
         spec:
           containers:
           - name: nginx
             image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
             ports:
             - containerPort: 80
             volumeMounts:
               - name: nas-pvc
                 mountPath: "/data"
           volumes:
             - name: nas-pvc
               persistentVolumeClaim:
                 claimName: nas-csi-pvc

2. 创建2个Deployment。

   kubectl create -f nginx-ns1.yaml -f nginx-ns2.yaml

3. 查看Pod状态。

   kubectl get pod -A -l app=nginx

   预期输出：

   NAMESPACE   NAME                         READY   STATUS    RESTARTS   AGE
   ns1         nas-test-b75d5b6bc-*****     1/1     Running   0          2m19s
   ns2         nas-test-b75d5b6bc-*****     1/1     Running   0          2m11s

4. 查看 Pod 详细配置，确认PVC挂载。

   将<namespace-name>、<pod-name>分别替换为实际NameSpace和Pod名称。

   kubectl describe pod -n <namespace-name> <pod-name> | grep "ClaimName:"

   预期输出中，两个Pod分别挂载了 ns1/nas-csi-pvc和 ns2/nas-csi-pvc。

控制台

1. 在ACK集群列表页面，单击目标集群名称，在集群详情页左侧导航栏，选择工作负载 > 无状态。

2. 在命名空间ns1下，创建一个Deployment，并挂载相应的PVC。

   1. 选择命名空间为ns1，单击使用镜像创建。

   2. 按照页面提示完成应用的创建。

      主要参数如下，其他参数保持默认即可。详见创建无状态工作负载Deployment。

      配置项	参数	说明
      应用基本信息	副本数量	Deployment的副本数量。
      容器配置	镜像名称	用于部署应用的镜像地址。
      	所需资源	所需的vCPU和内存资源。
      	数据卷	单击增加云存储声明，然后完成参数配置。 挂载源：选择之前创建的PVC。 容器路径：输入NAS文件系统要挂载到的容器路径，如/data。

3. 参见上一步，在命名空间ns2下，再次创建一个Deployment，并挂载相应的PVC。

   返回无状态页面，在命名空间ns1和ns2下，分别查看2个Deployment的部署情况，确认Pod已正常Running，且挂载了对应的PVC。