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 を持つ複数の PV) をマウントしないでください。ネイティブプロトコルは、異なるサブディレクトリであっても、同じファイルシステムを 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 アドオン (Container Service for Kubernetes (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 や reclaim ポリシーなどのプロビジョニングパラメーターを定義します。

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

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

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: alicloud-bmcpfs-test
   parameters:
     bmcpfsId: bmcpfs-xxxxxx
     vpcMountTarget: cpfs-xxxxx-vpc-xxxxx.cn-hangzhou.cpfs.aliyuncs.com
   provisioner: bmcpfsplugin.csi.alibabacloud.com
   reclaimPolicy: Delete
   volumeBindingMode: Immediate
   allowVolumeExpansion: false

2. StorageClass を適用します。

   kubectl apply -f sc.yaml

   期待される出力：

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

手順3：PVC の作成

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

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

   パラメーター	説明
   accessModes	ReadWriteMany のみ。複数ポッドによる同時アクセスが可能です。
   ストレージ	要求するストレージ容量。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. PVC を適用します。

   kubectl apply -f pvc.yaml

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

   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 の場合、PV は自動的に作成されます。プロビジョニングを確認します。

   kubectl describe pvc bmcpfs-vsc -n default

   イベントでプロビジョニング成功というメッセージを確認します。

手順4：ワークロードのデプロイと PVC のマウント

以下の 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で作成したPVCを参照します

2. Deployment を適用します。

   kubectl apply -f deploy.yaml

   期待される出力：

   deployment.apps/cpfs-shared-example created

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

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

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

   kubectl delete deployment <your-deployment-name>

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

   • 保持 (推奨): CPFS for LINGJUN のファイルセットとデータは保持されます。ステップ 3 に進み、PV を削除します。

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

   kubectl delete pvc <your-pvc-name>

3. PV の削除 (reclaimPolicy が Retain の場合のみ) — PVC を削除すると、PV は Released ステータスに移行します。これを削除すると Kubernetes リソースは削除されますが、バックエンドデータに影響はありません。

   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