Container Service for Kubernetes:Use NAS dynamic 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 のマウントオプション。デフォルトでは、ボリュームは NFSv3 を使用してマウントされます。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 ボリュームを使用すると、コントローラーのタスクキューが満杯になり、新しい 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 コンソールにログインします。左側のナビゲーションウィンドウで、クラスターリスト をクリックします。

2. クラスターリスト ページで、対象クラスターの名前をクリックします。左側のナビゲーションウィンドウで、ボリューム > ストレージクラス をクリックします。

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 のマウントオプション。デフォルトでは、ボリュームは NFSv3 を使用してマウントされます。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 が自動的に PersistentVolume (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 の使用 を選択します。
   既存のストレージクラス	ストレージクラスの選択 をクリックし、作成した StorageClass を選択します。
   合計容量	ストレージボリュームの必要な容量。デフォルトでは、この宣言はリソース要求として機能し、Pod が利用できる実際のストレージ容量を制限しません。 NAS ファイルシステムの容量制限は、その仕様によって決まります。詳細については、「汎用 NAS」および「エクストリーム NAS」をご参照ください。 ただし、StorageClass の allowVolumeExpansion が true に設定されている場合、この値は厳密に適用されるハードリミットになります。CSI プラグインは、この設定に基づいて NAS ディレクトリクォータを設定し、PV の利用可能な容量を制限します。
   アクセスモード	アクセスモード。有効な値： ReadWriteMany (デフォルト)：ボリュームは多くのノードから読み書き可能としてマウントできます。 ReadWriteOnce：ボリュームは単一のノードから読み書き可能としてマウントできます。 ReadOnlyMany：ボリュームは多くのノードから読み取り専用としてマウントできます。

kubectl

同じ PVC を参照する 2 つの Deployment を作成し、NAS ファイルシステムの同じサブパスを共有できるようにします。

同じ NAS ファイルシステムから異なるサブパスを異なる Pod にマウントするには、サブパスごとに一意の StorageClass と対応する 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 を検査して、正しい PersistentVolumeClaim (PVC) を使用していることを確認します。

   <podName> を各 Pod の実際の名前で置き換えてください。

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

   期待される出力では、両方の Pod が同じ PVC を使用しており、NAS ファイルシステムの同じサブパスを共有していることが確認されます。

コンソール

次の手順を繰り返して、同じ PVC を使用する 2 つの Deployment を作成し、NAS ファイルシステムの同じサブパスを共有できるようにします。

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

2. イメージを使用して作成 をクリックし、画面の指示に従ってアプリケーションを設定および作成します。

   主要なパラメーターは以下に説明されています。他のパラメーターはデフォルト値のままにできます。詳細については、「ステートレスアプリケーション (Deployment) の作成」をご参照ください。

   セクション	パラメーター	説明
   基本情報	Replicas:	Deployment のレプリカ数。
   コンテナー	画像	アプリケーションのデプロイに使用されるイメージのアドレス。
   	リソースリクエスト	コンテナが必要とする vCPU およびメモリリソース。
   	データボリューム	PVC を追加 をクリックし、パラメーターを設定します。 マウントソース：作成した PVC を選択します。 コンテナーパス：NAS ファイルシステムがマウントされるコンテナ内のパスを入力します。

   デプロイが完了したら、デプロイメント ページでアプリケーション名をクリックし、ポッド タブを確認して、Pod が正常に実行されていること (ステータスが Running) を確認できます。

kubectl

コンソール

1. クラスターリスト ページで、対象クラスターの名前をクリックします。左側のナビゲーションウィンドウで、ボリューム > ストレージクラス をクリックします。

2. 作成する をクリックし、StorageClass に一意の名前を指定し、ストレージタイプ として NAS を選択します。

   パラメーター	説明
   アタッチポイントの選択	NAS ファイルシステムのマウントターゲット。
   ストレージボリュームモード	ボリュームのプロビジョニングモード。この例では、sharepath モードを有効にする 共有ディレクトリ を選択します。
   マウントのパス	マウントする NAS サブディレクトリ。このパラメーターが指定されていない場合、デフォルトでルートディレクトリがマウントされます。 ディレクトリが NAS ファイルシステムに存在しない場合、自動的に作成されてからマウントされます。 汎用 NAS：ルートディレクトリは / です。 エクストリーム NAS：ルートディレクトリは /share です。サブディレクトリをマウントする場合、path は /share で始まる必要があります (例：/share/data)。
   リクレームポリシー	sharepath モードの場合、これは Retain である必要があります。
   マウントオプション	NFS プロトコルのバージョンを含む NAS のマウントオプション。デフォルトでは、ボリュームは NFSv3 を使用してマウントされます。vers=4.0 のようなオプションで異なるバージョンを指定できます。異なる NAS タイプでサポートされている NFS プロトコルの詳細については、「NFS プロトコル」をご参照ください。

kubectl

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

   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 ディレクトリクォータを設定し、PV の利用可能な容量を制限します。

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 の名前。名前は名前空間内で一意である必要があります。
   割り当てモード	StorageClass の使用を選択します。
   既存のストレージクラス	ストレージクラスの選択 をクリックし、作成した StorageClass を選択します。
   容量	ストレージボリュームの必要な容量。デフォルトでは、この宣言はリソース要求として機能し、Pod が利用できる実際のストレージ容量を制限しません。 NAS ファイルシステムの容量制限は、その仕様によって決まります。詳細については、「汎用 NAS」および「エクストリーム NAS」をご参照ください。 ただし、StorageClass の allowVolumeExpansion が true に設定されている場合、この値は厳密に適用されるハードリミットになります。CSI プラグインは、この設定に基づいて NAS ディレクトリクォータを設定し、PV の利用可能な容量を制限します。
   アクセスモード	アクセスモード。有効な値： ReadWriteMany (デフォルト)：ボリュームは多くのノードから読み書き可能としてマウントできます。 ReadWriteOnce：ボリュームは単一のノードから読み書き可能としてマウントできます。 ReadOnlyMany：ボリュームは多くのノードから読み取り専用としてマウントできます。

4. 前の手順に従って、ns2 名前空間にもう 1 つの 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. 名前空間ドロップダウンリストから 名前空間 を選択し、 イメージによる作成 をクリックします。

   2. 画面の指示に従ってアプリケーションを作成します。

      主要なパラメーターは以下に説明されています。他のパラメーターはデフォルト値のままにします。詳細については、「ステートレスワークロード (Deployment) の作成」をご参照ください。

      セクション	パラメーター	説明
      基本情報	Replicas:	Deployment のレプリカ数。
      コンテナー	画像	アプリケーションのデプロイに使用されるイメージのアドレス。
      	リソースリクエスト	必要な vCPU およびメモリリソース。
      	データボリューム	PVC を追加 をクリックし、パラメーターを設定します。 マウントソース：作成した PVC を選択します。 コンテナーパス：NAS ファイルシステムがマウントされるコンテナ内のパス (例：/data) を入力します。

3. 前の手順に従って、ns2 名前空間にもう 1 つの Deployment を作成し、対応する PVC をマウントします。

   デプロイメント ページに戻ります。`ns1` および `ns2` の名前空間で、各デプロイメントのステータスを確認し、Pod が実行中であり、正しい PVC がマウントされていることを確認します。