使用NAS存储卷

步骤一：获取NAS文件系统信息

1. 获取ACS Pod使用的VPC和交换机ID。

   说明

   以下步骤为控制台操作，也可以执行kubectl get cm -n kube-system acs-profile -o yaml命令查看acs-profile的YAML，在vpcId和vSwitchIds中获取Pod使用的VPC ID和交换机ID。

   1. 登录容器计算服务控制台。

   2. 在集群列表页面，单击目标集群名称，进入该集群的管理页面。

   3. 在左侧导航栏，选择配置管理 > 配置项。

   4. 在配置项页面上方将命名空间改为kube-system，然后找到acs-profile，单击YAML 编辑。

   5. 在vpcId和vSwitchIds中获取Pod使用的VPC ID和交换机ID。

2. 确认已有的NAS文件系统满足要求，并获取挂载点地址。

   1. 登录NAS文件系统控制台，在左侧导航栏，单击文件系统列表。

   2. 找到目标NAS文件系统，确认地域、可用区和协议类型满足要求。

      • NAS不支持跨VPC挂载，即不支持跨地域使用。请确保已有NAS的所属地域与ACS一致。

      • 同一VPC下，NAS可以跨可用区挂载，但建议和ACS集群中Pod使用的可用区一致，性能相对更优。

      • 确认NAS文件系统的协议类型为NFS。目前不支持挂载SMB协议的NAS文件系统。

      

   3. 确认挂载点满足要求，并获取挂载点地址。

      1. 单击文件系统ID。

      2. 在文件系统详情页左侧导航栏，单击挂载使用。

      3. 在挂载点区域，确认已有挂载点满足要求，然后获取挂载点地址。

         说明

         • 通用型NAS在创建文件系统时会自动创建一个挂载点，极速型NAS需要手动创建挂载点。

         • 如果已有挂载点不满足要求，可创建新的挂载点。具体操作，请参见管理挂载点。

         • 挂载点的VPC必须和ACS集群中Pod使用的VPC一致，否则会导致挂载失败。

         • 挂载点的交换机建议和ACS集群中Pod使用的交换机一致，性能相对更优。

         • 挂载点的状态为可用。

         

步骤二：创建StorageClass

1. 参考参数说明表修改以下YAML内容，并保存为nas-sc.yaml。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: alicloud-nas-subpath
   mountOptions:
   - nolock,tcp,noresvport
   - vers=3
   parameters:
     volumeAs: subpath
     server: *******-mw***.cn-shanghai.nas.aliyuncs.com
     path: "/csi"
   provisioner: nasplugin.csi.alibabacloud.com
   reclaimPolicy: Retain

   相关参数说明：

   参数	说明
   volumeAs	挂载方式。本示例设置为subpath，表示创建子目录类型的PV。一个PV对应一个NAS文件系统的子目录。
   server	NAS文件系统的挂载点地址。
   path	要挂载的NAS子目录。 如果未设置，则默认挂载到根目录。 如果NAS中没有该目录，会自动创建后再进行挂载。 通用型NAS的根目录为/，极速型NAS的根目录为/share。挂载极速型NAS的子目录时，path必须以/share开头，如/share/data。
   provisioner	驱动类型。必须配置为nasplugin.csi.alibabacloud.com，表示使用阿里云NAS CSI插件。
   reclaimPolicy	PV的回收策略。目前仅支持Retain，表示删除PV时，会保留对应的NAS文件系统和挂载点。

步骤三：创建PVC

步骤四：创建应用并挂载NAS

步骤一：创建StorageClass

1. 参考参数说明表修改以下YAML内容，并保存为nas-sc.yaml。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: alicloud-nas-fs
   mountOptions:
   - nolock,tcp,noresvport
   - vers=3
   parameters:
     volumeAs: filesystem
     fileSystemType: standard
     storageType: Performance
     regionId: cn-shanghai
     zoneId: cn-shanghai-e
     vpcId: "vpc-2ze2fxn6popm8c2mzm****"
     vSwitchId: "vsw-2zwdg25a2b4y5juy****"
     accessGroupName: DEFAULT_VPC_GROUP_NAME
     deleteVolume: "false"
   provisioner: nasplugin.csi.alibabacloud.com
   reclaimPolicy: Retain

   相关参数说明如下：

   重要

   不同类型和存储规格的NAS文件系统支持的地域、可用区不同。请根据业务的存储需求、ACS集群所属地域和ACS集群中Pod使用的VPC和交换机信息等确定需要在哪个地域、可用区，以及哪个VPC、交换机下创建什么类型的NAS文件系统和挂载点。相关参考如下：

   • 各类型NAS文件系统的存储规格、性能、计费、支持的地域和可用区等信息，请参见通用型NAS和极速型NAS。

   • 通用型NAS与极速型NAS在挂载连通性、文件系统数量及协议类型等方面存在相应约束条件。更多信息，请参见使用限制。

   • 可执行kubectl get cm -n kube-system acs-profile -o yaml命令查看acs-profile的YAML，在vpcId和vSwitchIds中获取Pod使用的VPC ID和交换机ID。

   参数	说明
   volumeAs	挂载方式。本实例设置为filesystem，表示会自动创建一个NAS文件系统，即一个NAS存储卷对应一个NAS文件系统。
   fileSystemType	NAS文件系统的类型。 standard（默认）：通用型NAS，更多信息，请参见通用型NAS。 extreme：极速型NAS，更多信息，请参见极速型NAS。
   storageType	NAS文件系统的存储规格。 对于通用型NAS，可选值如下： Performance（默认）：性能型 Capacity：容量型 对于极速型NAS，可选值如下： standard（默认）：标准型 advanced：高级型
   regionId	NAS文件系统所属地域。需与ACS集群所属地域保持一致。
   zoneId	NAS文件系统所属可用区。请根据ACS集群中Pod所使用的交换机，选择对应的可用区。 说明 同一VPC下，NAS可以跨可用区挂载。建议选择同一可用区，性能相对更优。
   vpcId、vSwitchId	NAS文件系统挂载点所属的VPC ID和交换机ID。需配置为ACS集群中Pod使用的VPC ID和交换机ID。
   accessGroupName	NAS文件系统挂载点的权限组。默认为DEFAULT_VPC_GROUP_NAME。
   provisioner	驱动类型。必须配置为nasplugin.csi.alibabacloud.com，表示使用阿里云NAS CSI插件。
   reclaimPolicy	PV的回收策略。目前仅支持Retain，表示删除PV时，会保留对应的NAS文件系统和挂载点。

2. 创建StorageClass。

   kubectl create -f nas-sc.yaml

3. 查看StorageClass。

   kubectl get sc

   预期返回：

   NAME                             PROVISIONER                       RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
   alicloud-nas-fs                  nasplugin.csi.alibabacloud.com    Retain          Immediate              false                  13m
   ......

步骤二：创建PVC

1. 将以下YAML内容保存为nas-pvc-fs.yaml。

   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata:
     name: nas-pvc-fs
   spec:
     accessModes:
       - ReadWriteMany
     storageClassName: alicloud-nas-fs
     resources:
       requests:
         storage: 20Gi

   相关参数说明如下：

   参数	说明
   accessModes	访问模式。
   storage	分配给Pod的存储容量，即要创建的NAS存储卷容量。 说明 由于极速型NAS有100 GiB的最小容量限制，如果StorageClass中定义的NAS文件系统类型为极速型NAS，此处storage的值必须≥100 GiB，否则无法创建对应的PV。
   storageClassName	要绑定的StorageClass名称。

2. 创建PVC。

   kubectl create -f nas-pvc-fs.yaml

3. 查看PVC。

   kubectl get pvc

   返回示例如下，PVC已关联自动创建的PV。可前往NAS文件系统控制台查看对应的NAS文件系统。

   NAME         STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS      VOLUMEATTRIBUTESCLASS  AGE
   nas-pvc-fs   Bound    nas-04a730ba-010d-4fb1-9043-476d8c38****   20Gi       RWX            alicloud-nas-fs   <unset>                14s

步骤三：创建应用并挂载NAS

1. 使用以下YAML内容，创建nas-test-fs.yaml文件。

   以下YAML示例可以创建包含2个Pod的Deployment，2个Pod均通过名为nas-pvc-fs的PVC申请存储资源，挂载路径均为/data。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nas-test
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest
           ports:
           - containerPort: 80
           volumeMounts:
             - name: pvc-nas
               mountPath: /data
         volumes:
           - name: pvc-nas
             persistentVolumeClaim:
               claimName: nas-pvc-fs

2. 创建Deployment并挂载NAS。

   kubectl create -f nas-test-fs.yaml

3. 查看Deployment中Pod的部署情况。

   kubectl get pod | grep nas-test

   返回示例如下，已创建2个Pod。

   nas-test-****-***a   1/1     Running   0          40s
   nas-test-****-***b   1/1     Running   0          40s

4. 查看挂载路径。

   kubectl exec nas-test-****-***a -- df -h /data

   预期输出：

   Filesystem                                        Size  Used Avail Use% Mounted on
   350514*****-mw***.cn-shanghai.nas.aliyuncs.com:/   10P     0   10P   0% /data

   如果输出类似信息，则表示挂载文件系统成功。

步骤一：获取NAS文件系统信息

请参考获取NAS文件系统信息，获取NAS挂载点地址。

步骤二：创建应用并挂载NAS

1. 使用以下YAML内容，创建nas-test-nfs.yaml文件。

   以下YAML示例可以创建包含2个Pod的Deployment，2个Pod均通过名为nfs-nas的volume将NAS文件系统挂载至/data路径。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nas-test
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest
           ports:
           - containerPort: 80
           volumeMounts:
             - name: nfs-nas
               mountPath: /data
         volumes:
         - name: nfs-nas
           nfs:
             server: file-system-id.region.nas.aliyuncs.com    # 阿里云NAS文件系统挂载点地址，请根据实际值替换。例如，7bexxxxxx-xxxx.ap-southeast-1.nas.aliyuncs.com。
             path: /    # NAS文件系统目录路径。该目录必须为已经存在的目录或根目录。通用型NAS的根目录为“/”，极速型NAS的根目录为“/share”。

2. 创建Deployment并挂载NAS。

   kubectl create -f nas-test-nfs.yaml

3. 查看Deployment中Pod的部署情况。

   kubectl get pod | grep nas-test

   返回示例如下，已创建2个Pod。

   nas-test-****-***a   1/1     Running   0          40s
   nas-test-****-***b   1/1     Running   0          40s

4. 查看挂载路径。

   kubectl exec nas-test-****-***a -- df -h /data

   预期输出：

   Filesystem                                        Size  Used Avail Use% Mounted on
   350514*****-mw***.cn-shanghai.nas.aliyuncs.com:/   10P     0   10P   0% /data

   如果输出类似信息，则表示挂载文件系统成功。