Container Service for Kubernetes:CPFS for Lingjun 動的ボリュームの使用

制限事項

これらの制約に違反すると、マウントの失敗や、クラスターが回復不能な状態に陥る原因となります。

• VSC マウントには同じ hpn-zone が必要：Pod のノードは、CPFS for Lingjun ファイルシステムと同じ hpn-zone に存在する必要があります。

• ノードの初期化：Lingjun ノードは、初期化時に CPFS for Lingjun ファイルシステムに関連付ける必要があります。これを省略すると、CSI マウントが失敗します。

• Pod あたり 1 つのファイルシステム：1 つの Pod に、同じ CPFS for Lingjun ファイルシステムから複数のボリュームをマウントしないでください (例：同じ bmcpfsId を持つ複数の PersistentVolume)。ネイティブプロトコルは、異なるサブディレクトリであっても、同じファイルシステムを 1 つの Pod 内で複数回マウントすることをサポートしていません。

• ノードをオフラインにする前のドレイン：障害が発生した Lingjun ノードをオフラインにする前に、すべての Pod をドレインしてください。これを省略すると、回復不能な Pod リソースと、クラスターメタデータの不整合が残ります。

前提条件

以下の要件を満たしていることを確認してください。

• クラスターバージョン 1.26 以降 (アップグレードガイド)。

• Alibaba Cloud Linux 3 を実行しているノード。

• 以下のストレージアドオンは、最小バージョンである必要があります。[アドオン] ページでインストールまたはアップグレードしてください。

  コンポーネント	最小バージョン
  CSI アドオン (csi-plugin および csi-provisioner)	v1.33.1
  cnfs-nas-daemon アドオン	0.1.2
  bmcpfs-csi アドオン (ACK マネージドコントロールプレーン上の bmcpfs-csi-controller と、クラスターノード上に DaemonSet としてデプロイされる bmcpfs-csi-node)	1.35.1

ステップ 1：CPFS ファイルシステムの作成

1. CPFS for Lingjun ファイルシステムを作成し、ファイルシステム ID を記録します。

2. (オプション) Lingjun 以外のノードにマウントする場合は、クラスターノードと同じ VPC 内に VPC マウントターゲットを作成します。マウントターゲットのドメイン名 (形式： cpfs-*-vpc-*.<Region>.cpfs.aliyuncs.com) を記録します。

   すべての Pod が Lingjun ノード上で実行される場合、VSC (Virtual Storage Controller) マウントがデフォルトで適用されるため、この手順はスキップできます。

続行する前に、CPFS for Lingjun の制限事項を確認してください。

ステップ 2：StorageClass の作成

StorageClass は、ファイルシステム ID や再利用ポリシーなどのプロビジョニングパラメーターを定義します。

1. sc.yaml を作成します。

   パラメーター	必須	説明
   bmcpfsId	はい	CPFS for Lingjun ファイルシステム ID。形式： bmcpfs-xxxxxxxxx または cpfs-xxxxxxxxx。
   path	いいえ	ファイルシステム内のサブディレクトリ。ボリュームは {path}/{volumeName}/ 配下に作成されます。デフォルトは /{volumeName}/ です。
   allowVolumeExpansion	いいえ	予約済みパラメーター。現在のバージョンでは動的拡張をサポートしていません。
   reclaimPolicy	いいえ	Delete (デフォルト)：PersistentVolumeClaim が削除されると、バックエンドのファイルセットを削除します。Retain：ファイルセットを保持するため、手動でのクリーンアップが必要です。本番環境では Retain の使用を推奨します。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: alicloud-bmcpfs-test
   provisioner: bmcpfsplugin.csi.alibabacloud.com
   parameters:
     # 必須： CPFS for Lingjun ファイルシステム ID (形式： bmcpfs-xxxxxxxxx または cpfs-xxxxxxxxx)
     bmcpfsId: bmcpfs-29000z8xz3lf5nj*****
     # オプション： ファイルシステム内のサブディレクトリ。ボリュームは {path}/{volumeName}/ 配下に作成されます
     # path: "/shared"
   # 予約済みパラメーター — 現在のバージョンでは動的拡張をサポートしていません
   allowVolumeExpansion: true
   # Delete (デフォルト)： PersistentVolumeClaim が削除されると自動的にファイルセットを削除します
   # Retain (本番環境推奨)： ファイルセットを保持します。手動でのクリーンアップが必要です
   reclaimPolicy: Delete

2. StorageClass を適用します。

   kubectl apply -f sc.yaml

   期待される出力：

   storageclass.storage.k8s.io/alicloud-bmcpfs-test created

ステップ 3：PersistentVolumeClaim の作成

PersistentVolumeClaim は StorageClass を参照して、動的にプロビジョニングされたストレージをリクエストします。

1. pvc.yaml を作成します。

   パラメーター	説明
   accessModes	ReadWriteMany のみ。複数の Pod からの同時アクセスを許可します。
   storage	リクエストするストレージ容量。Gi や Ti などの単位をサポートします。
   volumeMode	Filesystem のみがサポートされています。
   storageClassName	StorageClass 名。動的ボリューム作成をトリガーします。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: bmcpfs-vsc
     namespace: default
   spec:
     accessModes:
       - ReadWriteMany  # 複数の Pod 間での同時読み書きをサポートします
     resources:
       requests:
         storage: 10Ti  # 大容量ストレージ (Ti レベル) をサポートします
     volumeMode: Filesystem  # Filesystem のみがサポートされています
     storageClassName: alicloud-bmcpfs-test  # ステップ 2 で作成した StorageClass と一致する必要があります

2. PersistentVolumeClaim を適用します。

   kubectl apply -f pvc.yaml

3. PersistentVolumeClaim がバインドされたことを確認します。

   kubectl get pvc bmcpfs-vsc -n default

   期待される出力：

   NAME         STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS           AGE
   bmcpfs-vsc   Bound    pvc-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx   10Ti       RWX            alicloud-bmcpfs-test   30s

   STATUS が Bound の場合、PersistentVolume が自動的に作成されたことを示します。プロビジョニングの状況を確認します。

   kubectl describe pvc bmcpfs-vsc -n default

   イベントでProvisioning succeeded メッセージを確認します。

ステップ 4：ワークロードのデプロイと PersistentVolumeClaim のマウント

以下の Deployment は、単一の CPFS for Lingjun ボリュームを共有する 3 つのレプリカを実行します。

1. deploy.yaml を作成します。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: cpfs-shared-example
   spec:
     replicas: 3  # 3 つのレプリカで、複数の Pod 間で共有ストレージが機能することを検証します
     selector:
       matchLabels:
         app: cpfs-shared-app
     template:
       metadata:
         labels:
           app: cpfs-shared-app
       spec:
         tolerations:
           - key: node-role.alibabacloud.com/lingjun
             operator: Exists
             effect: NoSchedule
         # オプション： すべての Pod を特定のノードに固定する場合は、コメントを解除してノード名を設定してください
         # nodeName: cn-hangzhou.10.XX.XX.226
         containers:
         - name: app-container
           image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           volumeMounts:
             - name: pvc-cpfs
               mountPath: /data  # 共有ボリュームはコンテナ内の /data にマウントされます
           lifecycle:
             postStart:
               exec:
                 command:
                   - /bin/sh
                   - -c
                   - >
                     echo "Data written by $(hostname)" > /data/$(hostname).txt &&
                     echo "Deployment is running, check shared data in /data." &&
                     sleep 3600
         volumes:
           - name: pvc-cpfs
             persistentVolumeClaim:
               claimName: bmcpfs-vsc  # ステップ 3 で作成した PersistentVolumeClaim を参照します

2. Deployment を適用します。

   kubectl apply -f deploy.yaml

   期待される出力：

   deployment.apps/cpfs-shared-example created

リソースのクリーンアップ

予期しないコストを回避し、データの安全性を確保するために、この順序でリソースを削除してください。

1. ワークロードの削除 — PersistentVolumeClaim を使用しているすべてのアプリケーションを停止します。これによりボリュームがアンマウントされます。

   kubectl delete deployment <your-deployment-name>

2. PersistentVolumeClaim の削除 — 結果は StorageClass の reclaimPolicy によって異なります。

   • Retain (推奨)：CPFS for Lingjun のファイルセットとデータは保持されます。次の手順で PersistentVolume を削除してください。

   • Delete：バインドされた PersistentVolume とバックエンドのファイルセットが完全に削除されます。この操作は元に戻せません。

   kubectl delete pvc <your-pvc-name>

3. PersistentVolume の削除 (reclaimPolicy が Retain の場合のみ) — PersistentVolumeClaim の削除後、PersistentVolume は Released ステータスになります。Kubernetes リソースをクリーンアップするために、この PV を削除します。この操作はバックエンドのデータに影響しません。

   kubectl delete pv <your-pv-name>

4. (オプション) StorageClass の削除 — 不要になった場合は削除します。既存のボリュームには影響しません。

   kubectl delete sc <your-sc-name>

5. CPFS for Lingjun ファイルシステムの削除 — Retain ポリシーで保持されたデータを含め、すべてのデータが完全に削除されます。依存関係がないことを確認した上で、ファイルシステムを削除してください。

トラブルシューティング

kubectl describe pvc <your-pvc-name> -n <your-namespace>

# StorageClass の設定を確認します
kubectl get storageclass <your-sc-name> -o yaml

# CSI ドライバーが登録されていることを確認します
kubectl get csidriver bmcpfsplugin.csi.alibabacloud.com