Container Compute Service：使用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使用的交換器一致，效能相對更優。

         • 掛載點的狀態為可用。

         

步驟二：建立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

   如果輸出類似資訊，則表示掛載檔案系統成功。