File Storage NAS:NFS を使用して動的にプロビジョニングされた NAS ボリュームを使用する

kubectl

1. 次の YAML マニフェストを変更し、alicloud-nas-subpath.yaml として保存します。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: alicloud-nas-subpath
   mountOptions:
   - nolock,tcp,noresvport
   - vers=3
   parameters:
     volumeAs: subpath
     server: "0cd8b4a576-g****.cn-hangzhou.nas.aliyuncs.com:/k8s"
     archiveOnDelete: "true"
   provisioner: nasplugin.csi.alibabacloud.com
   reclaimPolicy: Retain
   allowVolumeExpansion: true

   パラメーター		説明
   mountOptions		NAS ボリュームのマウントオプションで、NFS プロトコルのバージョンを含みます。NFSv3 の使用を推奨します。超高速型 NAS は NFSv3 のみをサポートします。
   parameters	volumeAs	マウントメソッド。この例では、値を subpath に設定して、サブディレクトリタイプの PV を作成します。1 つの PV は NAS ファイルシステム内の 1 つのサブディレクトリに対応します。
   	server	マウントポイントのアドレスとマウントする NAS ファイルシステムのサブディレクトリ。フォーマットは <NAS マウントポイントアドレス>:<マウントディレクトリ> です。サブディレクトリを指定しない場合、デフォルトでルートディレクトリ / がマウントされます。
   	archiveOnDelete	reclaimPolicy が Delete に設定されている場合にバックエンドストレージのデータを削除するかどうかを指定します。NAS は共有ストレージサービスであるため、このパラメーターは確認のために追加されています。 true (デフォルト): ディレクトリまたはファイルは保持され、archived-{pvName}.{timestamp} に名前が変更されます。 false: バックエンドストレージリソースは完全に削除されます。 説明 高トラフィックのワークロードの場合、このパラメーターを false に設定することは推奨されません。詳細については、「NAS 永続ボリュームに関するよくある質問」をご参照ください。 バックエンドストレージのデータを完全に削除するには、kubectl を使用して parameters.archiveOnDelete を false に設定する必要があります。
   provisioner		ドライバーのタイプ。値は nasplugin.csi.alibabacloud.com に設定する必要があり、Alibaba Cloud NAS CSI プラグインが使用されることを示します。
   reclaimPolicy		PV のリクレームポリシー。デフォルト値は Delete です。Retain もサポートされています。 Delete: この値は archiveOnDelete と一緒に使用する必要があります。 archiveOnDelete が true の場合、PVC が削除されても NAS ファイルシステム内のファイルは名前が変更されるだけで削除されません。 archiveOnDelete が false の場合、PVC が削除されると NAS ファイルシステム内のファイルが削除されます。 重要 これにより、NAS ファイルシステム内の subpath ディレクトリとそのファイルが削除されます。NAS ファイルシステム自体は削除されません。NAS ファイルシステムを削除するには、「ファイルシステムの削除」をご参照ください。 Retain: PVC が削除されても、PV と NAS ファイルシステム内のファイルは保持されます。手動で削除する必要があります。 データのセキュリティが最優先事項である場合は、偶発的なデータ損失を防ぐために、このパラメーターを Retain に設定することをお勧めします。
   allowVolumeExpansion		汎用型 NAS ファイルシステムでのみサポートされます。true に設定すると、StorageClass によって動的に作成される PV にディレクトリクォータが構成され、利用可能な容量が制限されます。また、PVC を更新してボリューム容量を拡張することもできます。詳細については、「動的にプロビジョニングされた NAS ボリュームのディレクトリクォータを設定する」をご参照ください。 説明 NAS クォータは非同期で有効になります。PV が動的に作成された後、ディレクトリクォータがすぐに有効にならない場合があります。短時間で大量のデータを書き込むと、ストレージ使用量が容量制限を超える可能性があります。「ディレクトリクォータ」をご参照ください。

2. StorageClass を作成します。

   kubectl create -f alicloud-nas-subpath.yaml

コンソール

1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、[クラスター] をクリックします。

2. クラスター ページで、目的のクラスターを見つけてその名前をクリックします。左側のペインで、[ボリューム] > [ストレージクラス] を選択します。

3. [StorageClasses] ページで、[作成] をクリックします。

4. 表示されるダイアログボックスで、パラメーターを構成し、[OK] をクリックします。

   次の表に構成を示します。

   構成	説明	例
   [名前]	StorageClass の名前。フォーマット要件については UI を参照してください。	alicloud-nas-subpath
   [PV タイプ]	[NAS] を選択します。	NAS
   [マウントポイントの選択]	NAS ファイルシステムのマウントポイントのアドレス。	0cd8b4a576-g****.cn-hangzhou.nas.aliyuncs.com
   [ボリュームモード]	ボリュームのアクセスモード。この例では、subpath メソッドを使用するために [サブディレクトリ] を選択します。各 PV に対してマウントパスの下にユニークなサブディレクトリが自動的に作成されます。データは <NAS マウントポイント>:<マウントパス>/<pv-name>/ に保存されます。 説明 このモードには CSI コンポーネントのバージョン 1.31.4 以降が必要です。それ以外の場合、システムはデフォルトで共有ディレクトリモードになります。	サブディレクトリ
   [マウントパス]	マウントする NAS ファイルシステム上のサブディレクトリ。 設定しない場合、デフォルトでルートディレクトリがマウントされます。 指定したディレクトリが存在しない場合は、自動的に作成されてからマウントされます。 説明 ルートディレクトリは、汎用型 NAS ファイルシステムの場合は /、超高速型 NAS ファイルシステムの場合は /share です。超高速型 NAS ファイルシステムにサブディレクトリをマウントする場合、path は /share で始まる必要があります (例: /share/data)。	/k8s
   [リクレームポリシー]	PV のリクレームポリシー。偶発的なデータ損失を防ぐために [Retain] を推奨します。 [Delete]: このパラメーターは archiveOnDelete と一緒に構成する必要があります。コンソールで [Delete] を選択しても、PVC を削除する際に NAS ボリューム上のデータは実際には削除されません。これは、基盤となる archiveOnDelete パラメーターが UI を通じて構成できないためです。archiveOnDelete を構成するには、YAML マニフェストを使用して PV を作成します。YAML テンプレートについては、kubectl タブを参照してください。 [Retain]: PVC が削除されても、PV と NAS ボリューム上のデータは削除されません。手動で削除する必要があります。	Retain
   [マウントオプション]	NAS ボリュームのマウントオプションで、NFS プロトコルのバージョンを含みます。NFSv3 の使用を推奨します。超高速型 NAS は NFSv3 のみをサポートします。	デフォルト値を維持

   StorageClass が作成されると、[StorageClasses] リストで表示できます。

kubectl

1. YAML マニフェストを変更し、nas-pvc.yaml として保存します。

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

   パラメーター	説明
   accessModes	ボリュームのアクセスモード。デフォルト値は ReadWriteMany です。ReadWriteOnce と ReadOnlyMany もサポートされています。
   storageClassName	バインドする StorageClass の名前。
   storage	リクエストするボリュームの容量。 重要 デフォルトでは、NAS ボリュームの実際の利用可能容量はこの構成によって制限されません。これは NAS ファイルシステムの仕様によって決まります。詳細については、「汎用型 NAS」および「超高速型 NAS」をご参照ください。 汎用型 NAS ファイルシステムを使用し、StorageClass の allowVolumeExpansion を true に設定した場合、CSI コンポーネントはこの構成に基づいてディレクトリクォータを設定し、NAS ボリュームの利用可能容量を制限します。

2. PVC を作成します。

   kubectl create -f nas-pvc.yaml

3. PV が作成され、PVC にバインドされたことを確認します。

   kubectl get pvc

   出力には STATUS が Bound と表示され、CSI コンポーネントが StorageClass に基づいて自動的に PV を作成し、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. [永続ボリューム要求] ページで、[作成] をクリックします。

3. [PVC の作成] ダイアログボックスで、パラメーターを構成し、[OK] をクリックします。

   構成	説明	例
   [PVC タイプ]	[NAS] を選択します。	[NAS]
   [名前]	PVC の名前。名前空間内で一意である必要があります。	pvc-nas
   割り当てモード	この例では、[StorageClass の使用] を選択します。	[StorageClass の使用]
   [既存の StorageClass]	[StorageClass の選択] をクリックし、前のステップで作成したものを選択します。	alicloud-nas-subpath
   [容量]	ボリュームの容量。この設定は、アプリケーションが使用できる最大容量を制限するものではありません。 重要 デフォルトでは、NAS ボリュームの実際の利用可能容量はこの構成によって制限されません。これは NAS ファイルシステムの仕様によって決まります。詳細については、「汎用型 NAS」および「超高速型 NAS」をご参照ください。 汎用型 NAS ファイルシステムを使用し、StorageClass の allowVolumeExpansion を true に設定した場合、CSI コンポーネントはこの構成に基づいてディレクトリクォータを設定し、NAS ボリュームの利用可能容量を制限します。	20Gi
   [アクセスモード]	デフォルト値は [ReadWriteMany] です。[ReadWriteOnce] または [ReadOnlyMany] を選択することもできます。	[ReadWriteMany]

kubectl

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

1. 次の YAML マニフェストを変更し、ファイルをそれぞれ nginx-1.yaml と nginx-2.yaml として保存します。

   nginx-1.yaml と nginx-2.yaml の次の構成は、metadata.name の値を除いて同じです。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
               mountPath: "/data"           # NAS ボリュームがコンテナーにマウントされるパス
         volumes:
           - name: nas-pvc                 
             persistentVolumeClaim:
               claimName: nas-csi-pvc       # 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
               mountPath: "/data"           # NAS ボリュームがコンテナーにマウントされるパス
         volumes:
           - name: nas-pvc                 
             persistentVolumeClaim:
               claimName: nas-csi-pvc       # PVC をバインドするために使用

2. 2 つの Deployment を作成します。

   kubectl create -f nginx-1.yaml -f nginx-2.yaml

3. Pod が実行中であることを確認します。

   kubectl get pod -l app=nginx

   出力は、同じ NAS ファイルシステムの同じサブディレクトリが異なるアプリケーションにマウントされていることを示します。

   NAME                         READY   STATUS    RESTARTS   AGE
   nas-test-1-b75d5b6bc-vqwq9   1/1     Running   0          51s
   nas-test-2-b75d5b6bc-8k9vx   1/1     Running   0          44s

コンソール

次の手順を繰り返して、同じ PVC をマウントする 2 つの Deployment を作成し、NAS ファイルシステム内の単一のサブディレクトリを共有できるようにします。

1. クラスター詳細ページの左側のナビゲーションペインで、[ワークロード] > [デプロイメント] に移動します。

2. [デプロイメント] ページで、[イメージから作成] をクリックします。

3. パラメーターを構成してアプリケーションを作成します。

   次の表に主要なパラメーターを示します。他のパラメーターはデフォルト設定のままにできます。詳細については、「ステートレスワークロード (Deployment) の作成」をご参照ください。

   構成ステップ	パラメーター	説明	例
   [基本情報]	[名前]	Deployment のカスタム名を入力します。名前はコンソールに表示されるフォーマット要件を満たす必要があります。	deployment-nas-1
   	[レプリカ]	Pod レプリカの数。	1
   [コンテナー]	[イメージ名]	アプリケーションのデプロイに使用されるイメージのアドレス。	anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
   	[必須リソース]	必要な vCPU とメモリリソース。	0.25 vCPU, 512 MiB
   	[ボリューム]	[PVC の追加] をクリックし、パラメーターを構成します。 [マウントソース]: 作成した PVC を選択します。 [コンテナーパス]: NAS ファイルシステムをマウントするコンテナーパスを指定します。	マウントソース: pvc-nas コンテナーパス: /data

4. アプリケーションのデプロイステータスを表示します。

   1. [デプロイメント] ページで、アプリケーションの名前をクリックします。

   2. [Pod] タブで、Pod が [実行中] 状態であることを確認します。

kubectl

コンソール

1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、[クラスター] をクリックします。

2. クラスター ページで、目的のクラスターを見つけてその名前をクリックします。左側のペインで、[ボリューム] > [ストレージクラス] を選択します。

3. [StorageClasses] ページで、[作成] をクリックします。

4. 表示されるダイアログボックスで、パラメーターを構成し、[OK] をクリックします。

   次の表に主要な構成を示します。

   構成	説明	例
   [名前]	StorageClass の名前。フォーマット要件については UI を参照してください。	alicloud-nas-sharepath
   [PV タイプ]	[NAS] を選択します。	[NAS]
   [マウントポイントの選択]	NAS ファイルシステムのマウントポイントのアドレス。	0cd8b4a576-g****.cn-hangzhou.nas.aliyuncs.com
   [ボリュームモード]	ボリュームのアクセスモード。この例では、sharepath メソッドを使用するために [共有ディレクトリ] を選択します。PV が作成されるとき、実際のディレクトリは作成されません。代わりに、StorageClass で指定されたパスが使用されます。これは、各 PV が同じ NAS ディレクトリにマッピングされることを意味します。このメソッドは、名前空間をまたいでディレクトリを共有する必要があるシナリオに最適です。	[共有ディレクトリ]
   [マウントパス]	マウントする NAS ファイルシステム上のサブディレクトリ。 設定しない場合、デフォルトでルートディレクトリがマウントされます。 指定したディレクトリが存在しない場合は、自動的に作成されてからマウントされます。 説明 ルートディレクトリは、汎用型 NAS ファイルシステムの場合は /、超高速型 NAS ファイルシステムの場合は /share です。超高速型 NAS ファイルシステムにサブディレクトリをマウントする場合、path は /share で始まる必要があります (例: /share/data)。	/sharepath
   [リクレームポリシー]	sharepath メソッドを使用する場合、このパラメーターを Retain に設定する必要があります。	Retain
   [マウントオプション]	NAS ボリュームのマウントオプションで、NFS プロトコルのバージョンを含みます。NFSv3 の使用を推奨します。超高速型 NAS は NFSv3 のみをサポートします。	デフォルト値を維持

   StorageClass が作成されると、[ストレージクラス] リストで表示できます。

kubectl

NAS ボリュームを異なる名前空間の Pod にマウントするには、まず 2 つの名前空間を作成します。

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

   kubectl create ns ns1
   kubectl create ns ns2

2. 次の YAML マニフェストを変更し、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	リクエストするボリュームの容量。 重要 デフォルトでは、NAS ボリュームの実際の利用可能容量はこの構成によって制限されません。これは NAS ファイルシステムの仕様によって決まります。詳細については、「汎用型 NAS」および「超高速型 NAS」をご参照ください。 汎用型 NAS ファイルシステムを使用し、StorageClass の allowVolumeExpansion を true に設定した場合、CSI コンポーネントはこの構成に基づいてディレクトリクォータを設定し、NAS ボリュームの利用可能容量を制限します。

3. PVC を作成します。

   kubectl create -f pvc.yaml

4. PV が作成され、PVC にバインドされたことを確認します。

   kubectl get pv

   出力は、CSI コンポーネントが StorageClass に基づいて自動的に 2 つの PV を作成し、それらを異なる名前空間の 2 つの 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 名前空間に PVC を作成します。

   1. [永続ボリューム要求] ページで、[名前空間] を [ns1] に設定し、[作成] をクリックします。

   2. [PVC の作成] ダイアログボックスで、パラメーターを構成し、[OK] をクリックします。

      構成	説明	例
      [PVC タイプ]	[NAS] を選択します。	[NAS]
      [名前]	PVC の名前。名前空間内で一意である必要があります。	pvc-nas
      [割り当てモード]	この例では、[StorageClass の使用] を選択します。	[StorageClass の使用]
      [既存の StorageClass]	[StorageClass の選択] をクリックし、作成したものを選択します。	alicloud-nas-sharepath
      [容量]	ボリュームの容量。	20Gi
      [アクセスモード]	デフォルト値は [ReadWriteMany] です。[ReadWriteOnce] または [ReadOnlyMany] を選択することもできます。	[ReadWriteMany]

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

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

kubectl

1. 次の YAML コンテンツをそれぞれ nginx-ns1.yaml と nginx-ns2.yaml として保存し、必要に応じて変更します。

   nginx-ns1.yaml と nginx-ns2.yaml の次の構成は、metadata.namespace の値を除いて同じです。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

   出力は、同じ NAS ファイルシステムの同じサブディレクトリが異なる名前空間の Pod にマウントされていることを示します。

   NAMESPACE   NAME                         READY   STATUS    RESTARTS   AGE
   ns1         nas-test-b75d5b6bc-ljvfd     1/1     Running   0          2m19s
   ns2         nas-test-b75d5b6bc-666hn     1/1     Running   0          2m11s

コンソール

1. クラスター詳細ページの左側のナビゲーションペインで、[ワークロード] > [デプロイメント] に移動します。

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

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

   2. パラメーターを構成してアプリケーションを作成します。

      次の表に主要なパラメーターを示します。他のパラメーターはデフォルト設定のままにできます。詳細については、「ステートレスワークロード (Deployment) の作成」をご参照ください。

      構成ステップ	パラメーター	説明	例
      [基本情報]	[名前]	Deployment のカスタム名を入力します。名前はコンソールに表示されるフォーマット要件を満たす必要があります。	nginx
      	[レプリカ]	Pod レプリカの数。	2
      [コンテナー]	[イメージ名]	アプリケーションのデプロイに使用されるイメージのアドレス。	anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
      	[必須リソース]	必要な vCPU とメモリリソース。	0.25 vCPU, 512 MiB
      	[ボリューム]	[PVC の追加] をクリックし、パラメーターを構成します。 [マウントソース]: 作成した PVC を選択します。 [コンテナーパス]: NAS ファイルシステムをマウントするコンテナーパスを指定します。	マウントソース: pvc-nas コンテナーパス: /data

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

4. [デプロイメント] ページに戻ります。ns1 と ns2 の名前空間で、2 つの Deployment のステータスを表示します。Pod が実行中であり、対応する PVC がマウントされていることを確認します。