Container Service for Kubernetes：使用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: "0cd8b4a576-g****.cn-hangzhou.nas.aliyuncs.com"
     path: "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掛載點地址。 關於如何查看掛載點地址，請參見管理掛載點。
   parameters.path		待掛載的NAS子目錄。如果未設定，則預設掛載到根目錄。 如果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. 登入Container Service管理主控台，在左側導覽列選擇叢集列表。

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。