Container Service for Kubernetes:Use NAS dynamically provisioned volumes

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		NFS プロトコルのバージョンを含む NAS のマウントオプション。デフォルトでは、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 サブディレクトリとその内容のみが削除され、NAS ファイルシステム自体は削除されません。 NAS ファイルシステムを削除するには、「ファイルシステムの削除」をご参照ください。 PV の作成と削除が頻繁に行われるシナリオでは、これを false に設定すると、CSI コントローラーのタスクキューがブロックされ、新しい PV が作成できなくなる可能性があります。詳細については、「NAS の動的にプロビジョニングされたボリュームを使用すると、CSI コントローラーのタスクキューが満杯になり、新しい PV を作成できない」をご参照ください。
   provisioner		ドライバーのタイプ。Alibaba Cloud 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. ACK コンソールにログインします。ACK コンソール。左側のナビゲーションウィンドウで、[クラスター] をクリックします。

3. [作成] をクリックします。クラスター内の StorageClass に一意の名前を入力し、[ボリュームタイプ] を NAS に設定します。プロンプトに従って StorageClass の作成を完了します。

   以下の表に、主な設定項目を説明します。

   設定項目	説明
   マウントポイントの選択	NAS ファイルシステムのマウントポイントのアドレス。
   ボリュームモード	ボリュームアクセスモードです。この例では、[サブディレクトリ]（サブパス）を選択します。システムはマウントパスの下に自動的にサブディレクトリを作成します。データは<NAS マウントポイント>:<マウントパス>/<pv-name>/の下に保存されます。
   マウントパス	マウントする NAS ファイルシステムのサブディレクトリ。このパラメーターを設定しない場合、デフォルトでルートディレクトリがマウントされます。 ディレクトリが NAS ファイルシステムに存在しない場合、自動的に作成されてマウントされます。 汎用型 NAS ファイルシステム：ルートディレクトリは / です。 超高速型 NAS ファイルシステム：ルートディレクトリは /share です。サブディレクトリをマウントする場合、path は /share で始まる必要があります (例：/share/data)。
   リサイクルポリシー	PV のリサイクルポリシー。 Delete (デフォルト)：PVC を削除すると、システムは archiveOnDelete の設定に従ってバックエンドストレージデータを処理します。 Retain：PVC を削除しても、PV と NAS ファイルはそのまま残ります。手動で削除する必要があります。偶発的なデータ損失を防ぐために、高いセキュリティが求められるシナリオで使用します。
   マウントオプション	NFS プロトコルのバージョンを含む 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 ディレクトリクォータを設定します。

2. PVC を作成します。

   kubectl create -f nas-pvc.yaml

3. PV を表示します。

   kubectl get pv

   期待される出力：PV は自動的に作成され、StorageClass に基づいて 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 ディレクトリクォータを設定します。
   アクセスモード	アクセスモード。有効な値： ReadWriteMany (デフォルト)：ボリュームは多くのノードから読み書き可能としてマウントできます。 ReadWriteOnce：ボリュームは単一のノードから読み書き可能としてマウントできます。 ReadOnlyMany：ボリュームは多くのノードから読み取り専用としてマウントできます。

kubectl

2 つの Deployment を作成し、同じ PVC をマウントして、同じ NAS ファイルシステムの同じサブディレクトリを共有します。

同じ NAS ファイルシステムの異なるサブディレクトリを複数の Pod にマウントするには、サブディレクトリごとに個別の StorageClass と対応する PVC を作成し、それぞれの PVC を個別にマウントする必要があります。

1. 次の内容で nginx-1.yaml と nginx-2.yaml という名前の 2 つのファイルを作成します。

   両方のアプリケーションの設定はほぼ同じです。どちらも同じ 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 クラスター」ページで、対象クラスターの名前をクリックします。左側のナビゲーションウィンドウで、Workloads > Deployments を選択します。

2. [イメージから作成] をクリックします。指示に従ってアプリケーションを設定し、作成します。

   以下の表に、主なパラメーターを説明します。他のパラメーターはデフォルト値のままにします。詳細については、「Deployment の作成」をご参照ください。

   設定項目	パラメーター	説明
   アプリケーションの基本	レプリカ	Deployment のレプリカ数。
   コンテナー設定	イメージ名	アプリケーションのデプロイに使用するイメージアドレス。
   	必須リソース	必要な vCPU とメモリリソース。
   	ボリューム	[クラウドストレージ要求の追加] をクリックし、構成を完了します。 マウントソース：以前に作成した PVC を選択します。 コンテナーパス：NAS ファイルシステムがマウントされるコンテナー内のパスを入力します。

   デプロイメントが完了すると、[ステートレス] ページでアプリケーション名をクリックし、[コンテナーグループ] タブで Pod が正常に Running していることを確認できます。Pod のステータスは Running である必要があります。

kubectl

コンソール

2. 「[作成]」をクリックします。クラスター内の StorageClass に一意の名前を入力し、「[ボリュームタイプ]」を NAS に設定します。プロンプトに従って StorageClass の作成を完了します。

   設定項目	説明
   マウントポイントの選択	NAS ファイルシステムのマウントポイントのアドレス。
   ボリュームモード	ボリューム アクセス モード。この例では、[共有ディレクトリ] (sharepath) を選択します。
   マウントパス	マウントする NAS ファイルシステムのサブディレクトリ。このパラメーターを設定しない場合、デフォルトでルートディレクトリがマウントされます。 ディレクトリが NAS ファイルシステムに存在しない場合、自動的に作成されてマウントされます。 汎用型 NAS ファイルシステム：ルートディレクトリは / です。 超高速型 NAS ファイルシステム：ルートディレクトリは /share です。サブディレクトリをマウントする場合、path は /share で始まる必要があります (例：/share/data)。
   リサイクルポリシー	sharepath の場合、これを Retain に設定します。
   マウントオプション	NFS プロトコルのバージョンを含む NAS のマウントオプション。デフォルトでは、NAS は NFS v3 を使用してマウントします。別のバージョンを指定するには、vers=4.0 を使用します。NAS タイプごとにサポートされている NFS バージョンについては、「NFS プロトコル」をご参照ください。

kubectl

1. `ns1` と `ns2` の名前空間を作成します。

   kubectl create ns ns1
   kubectl create ns ns2

2. `ns1` と `ns2` の名前空間に同じ名前の PVC を作成するために、pvc.yaml という名前のファイルを作成します。

   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 ディレクトリクォータを設定します。

3. PVC を作成します。

   kubectl create -f pvc.yaml

4. PV のステータスを確認し、PV が自動的に作成され、PVC にバインドされたことを確認します。

   kubectl get pv

   期待される出力：両方の PV のステータスは Bound です。CLAIM 列は、各 PV が異なる名前空間 (ns1/nas-csi-pvc と ns2/nas-csi-pvc) の 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 名。名前空間内で一意である必要があります。
   割り当てモード	[ストレージクラスを使用して動的に作成] を選択します。
   既存のストレージクラス	[ストレージクラスの選択] をクリックし、以前に作成したストレージクラスを選択します。
   合計	必要なボリューム容量を宣言します。デフォルトでは、これはリソース要求として機能し、Pod が利用できる実際のストレージスペースを制限しません。 NAS の最大容量は仕様によって異なります。詳細については、「汎用型 NAS」および「超高速型 NAS」をご参照ください。 ただし、StorageClass で allowVolumeExpansion が true に設定されている場合、この値はハードリミットになります。CSI ドライバーは、この制限を強制するために NAS ディレクトリクォータを設定します。
   アクセスモード	アクセスモード。有効な値： ReadWriteMany (デフォルト)：ボリュームは多くのノードから読み書き可能としてマウントできます。 ReadWriteOnce：ボリュームは単一のノードから読み書き可能としてマウントできます。 ReadOnlyMany：ボリュームは多くのノードから読み取り専用としてマウントできます。

4. 前の手順を繰り返して、`ns2` 名前空間に PVC を作成します。

   PVC が作成されたら、[永続ボリューム要求] ページに戻り、`ns1` および `ns2` 名前空間内の PVC が自動的に作成された PV にバインドされていることを確認します。

kubectl

1. 次の内容で nginx-ns1.yaml と nginx-ns2.yaml という名前の 2 つのファイルを作成します。

   両方のアプリケーションの設定はほぼ同じです。それぞれがそれぞれの名前空間の 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> を実際の名前空間と Pod 名に置き換えてください。

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

   期待される出力では、2 つの Pod はそれぞれ ns1/nas-csi-pvc と ns2/nas-csi-pvc をマウントしています。

コンソール

1. 「ACK クラスター」ページで、対象クラスターの名前をクリックします。左側のナビゲーションウィンドウで、Workloads > Deployments を選択します。

2. `ns1` 名前空間に Deployment を作成し、対応する PVC をマウントします。

   1. [名前空間] を [ns1] に設定し、[イメージから作成] をクリックします。

   2. プロンプトに従ってアプリケーションの作成を完了します。

      以下の表に、主なパラメーターを説明します。他のパラメーターはデフォルト値のままにします。詳細については、「Deployment の作成」をご参照ください。

      設定項目	パラメーター	説明
      アプリケーションの基本	レプリカ	Deployment のレプリカ数。
      コンテナー設定	イメージ名	アプリケーションのデプロイに使用するイメージアドレス。
      	必須リソース	必要な vCPU とメモリリソース。
      	ボリューム	[クラウドストレージ要求の追加] をクリックし、構成を完了します。 マウントソース：以前に作成した PVC を選択します。 コンテナーパス：NAS ファイルシステムがマウントされるコンテナー内のパス (例：/data) を入力します。

3. 前の手順を繰り返して、`ns2` 名前空間に Deployment を作成し、対応する PVC をマウントします。

   「[ステートレス]」ページに戻って、名前空間 ns1 および ns2 内の 2 つのデプロイメントのステータスを確認し、対応する PVC がマウントされた状態で Pod が正常に実行されていることを確認できます。