Container Compute Service:NAS ボリュームの使用

ステップ 1： NAS ファイルシステム情報の取得

1. ACS Pod で使用されている VPC ID と vSwitch ID を取得します。次のコマンドを実行して acs-profile ConfigMap を読み取ります：

   1. ACS コンソールにログインします。

   2. 「[クラスター]」ページで、クラスター名をクリックします。

   3. 左側のナビゲーションウィンドウで、[設定] ＞ [ConfigMap] を選択します。

   4. 名前空間を [kube-system] に設定し、acs-profile を見つけ、[YAML の編集] をクリックします。

   5. vpcId および vSwitchIds の値をコピーします。

   kubectl get cm -n kube-system acs-profile -o yaml

   出力で vpcId フィールドと vSwitchIds フィールドを探します。または、ACS コンソールからこれらの値を取得します：

2. NAS ファイルシステムに互換性があることを確認し、そのマウントターゲットアドレスを取得します。

   1. 「NAS コンソール」にログインし、[ファイルシステム一覧] をクリックします。

   2. ご利用の NAS ファイルシステムを見つけ、以下を確認します：

      • NAS ファイルシステムが ACS クラスターと同じリージョンにあること。NAS ファイルシステムは、リージョンや VPC をまたいでマウントすることはできません。

      • NAS ファイルシステムは、[NFS] プロトコルを使用します。SMB はサポートされていません。

      • 最高のパフォーマンスを得るには、NAS ファイルシステムが Pod と同じゾーンにあることが推奨されます。同じ VPC 内であれば、ゾーン間のマウントはサポートされています。

   3. マウントターゲットアドレスを取得します：

      1. ファイルシステム ID をクリックして、ファイルシステムの詳細ページを開きます。

      2. 左側のナビゲーションウィンドウで、[マウントターゲット] をクリックします。

      3. マウントポイントが以下の要件を満たしていることを確認し、そのアドレスをコピーします。> [注意] 汎用型 NAS では、マウントポイントが自動的に作成されます。超高速型 NAS ファイルシステムでは、マウントポイントを手動で作成する必要があります。適切なマウントポイントがない場合は、「マウントポイントの管理」をご参照ください。

         • マウントターゲットが Pod と同じ VPC にあること。VPC が異なる場合、マウントは失敗します。

         • 最高のパフォーマンスを得るには、マウントターゲットの vSwitch が Pod で使用されている vSwitch と一致することが推奨されます。

         • マウントポイントのステータスは [利用可能] です。

ステップ 2： PVC の作成

ステップ 3： デプロイメントを作成し、NAS ボリュームをマウント

ステップ 1： StorageClass の作成

1. 以下の内容を nas-sc.yaml として保存し、プレースホルダー値をお客様の ACS クラスターの値に置き換えます。VPC ID および vSwitch ID を取得するには、次のコマンドを実行します：

   パラメーター	必須	説明
   volumeAs	必須	filesystem である必要があります。各 NAS ボリュームは、1 つの NAS ファイルシステムに対応します。
   fileSystemType	必須	standard（デフォルト）、エクストリーム NAS の場合は extreme を指定します。
   storageType	必須	ファイルシステムタイプ内のストレージクラスです。 汎用 NAS： Performance（デフォルト、コンピューティング最適化）または Capacity（ストレージ最適化）。 エクストリーム NAS： standard（デフォルト、中間）または advanced。
   regionId	必須	NAS ファイルシステムのリージョンです。ご利用の ACK クラスターのリージョンと一致させる必要があります。
   zoneId	必須	NAS ファイルシステムのゾーンです。Pod で使用する vSwitch に基づいてゾーンを選択してください。同一 VPC 内でのクロスゾーンマウントはサポートされていますが、同一ゾーンを使用することで、より高いパフォーマンスが得られます。
   vpcId、vSwitchId	必須	NAS マウントポイントの VPC および vSwitch ID です。ご利用の Pod で使用する VPC および vSwitch と一致させる必要があります。
   accessGroupName	任意	マウントポイントのアクセス許可グループです。デフォルト値は DEFAULT_VPC_GROUP_NAME です。
   provisioner	必須	nasplugin.csi.alibabacloud.com である必要があります。
   reclaimPolicy	必須	有効な値は Retain のみです。PV が削除された場合、NAS ファイルシステムおよびマウントポイントは保持されます。

   kubectl get cm -n kube-system acs-profile -o 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

   主要なパラメーター：

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
   ......

ステップ 2： PVC の作成

1. 以下の内容を nas-pvc-fs.yaml として保存します。

   パラメーター	説明
   accessModes	アクセスモード。
   storageClassName	作成した StorageClass の名前と一致する必要があります。
   storage	NAS ボリュームのストレージ容量。超高速型 NAS ファイルシステムの場合、最小値は 100 GiB です。より小さい値を設定すると、PV の作成が妨げられます。

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

   主要なフィールド：

2. PVC を作成します：

   kubectl create -f nas-pvc-fs.yaml

3. PVC がバインドされていることを確認します：

   kubectl get pvc

   期待される出力：

   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

   PVC は自動的にプロビジョニングされた PV にバインドされます。対応する NAS ファイルシステムは NAS コンソールで確認できます。

ステップ 3： デプロイメントを作成し、NAS ボリュームをマウント

1. 以下の内容を nas-test-fs.yaml として保存します。このデプロイメントでは、nas-pvc-fs PVC を /data にマウントする 2 つの Pod が作成されます。

   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    # マウント先アドレス。例: 7bexxxxxx-xxxx.ap-southeast-1.nas.aliyuncs.com
             path: /    # NASファイルシステム内のディレクトリのパス。このディレクトリは既存のディレクトリかルートディレクトリである必要があります。汎用型 NAS のルートディレクトリは "/" です。超高速型 NAS ファイルシステムのルートディレクトリは "/share" です。

2. デプロイメントを作成します：

   kubectl create -f nas-test-fs.yaml

3. 両方の Pod が実行中であることを確認します：

   kubectl get pod | grep nas-test

   期待される出力:

   nas-test-****-***a   1/1     Running   0          40s
   nas-test-****-***b   1/1     Running   0          40s

4. NAS ファイルシステムがマウントされていることを確認します：

   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

ステップ 1： NAS マウントターゲットアドレスの取得

「ステップ 1： NAS ファイルシステム情報の取得」の手順に従って、マウントターゲットアドレスを取得します。

ステップ 2： デプロイメントの作成

1. 次の内容を nas-test-nfs.yaml として保存し、server の値を実際の マウントターゲットアドレス に置き換えてください。この デプロイメント は、インライン NFS ボリューム を使用して NAS ファイルシステム を /data にマウントする 2 つの Pod を作成します。

   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    # マウントターゲットアドレス。例: 7bexxxxxx-xxxx.ap-southeast-1.nas.aliyuncs.com
             path: /    # NAS ファイルシステム内のディレクトリのパス。ディレクトリは既存のディレクトリまたはルートディレクトリである必要があります。汎用型 NAS ファイルシステムのルートディレクトリは "/" です。超高速型 NAS ファイルシステムのルートディレクトリは "/share" です。

2. デプロイメントを作成します：

   kubectl create -f nas-test-nfs.yaml

3. 両方の Pod が実行中であることを確認します：

   kubectl get pod | grep nas-test

   期待される出力：

   nas-test-****-***a   1/1     Running   0          40s
   nas-test-****-***b   1/1     Running   0          40s

4. NAS ファイルシステムがマウントされていることを確認します：

   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

共有ストレージの確認

1. Pod 名を取得します：

   kubectl get pod | grep nas-test

   出力例：

   nas-test-****-***a   1/1     Running   0          40s
   nas-test-****-***b   1/1     Running   0          40s

2. 一方の Pod からファイルを作成します：

   test.txt

3. もう一方の Pod からファイルを読み取ります：

   kubectl exec nas-test-****-***b -- ls /data

   期待される出力：

   test.txt

   test.txt は両方の Pod から表示され、共有ストレージが機能していることを確認できます。

データの永続性の確認

1. デプロイメントを再起動して新しい Pod を作成します：

   kubectl rollout restart deploy nas-test

2. 新しい Pod の準備が整うのを待ちます：

   kubectl get pod | grep nas-test

   出力例：

   nas-test-****-***c   1/1     Running   0          67s
   nas-test-****-***d   1/1     Running   0          49s

3. 新しい Pod からファイルを読み取ります：

   kubectl exec nas-test-****-***c -- ls /data

   期待される出力：

   test.txt

   test.txt は Pod が置き換えられた後も存在することから、NAS ファイルシステムが Pod の再起動をまたいでデータを永続化することが確認できます。