Container Service for Kubernetes:ENS ディスクの使用

ステップ 1：StorageClass の作成

ENS CSI では、2 種類のボリュームバインディングモードがサポートされています。デプロイメントに応じて、いずれかを選択してください。

オプション 1：WaitForFirstConsumer（推奨）

1. 以下の内容で storage-class-topology.yaml というファイルを作成します。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: alicloud-ens-disk-available
   provisioner: ensplugin.csi.alibabacloud.com
   parameters:
     type: available
     fsType: ext4
   volumeBindingMode: WaitForFirstConsumer
   reclaimPolicy: Retain
   allowVolumeExpansion: false

2. StorageClass を適用します。

   kubectl apply -f storage-class-topology.yaml

3. StorageClass が正しく作成されたことを確認します。

   kubectl get storageclass alicloud-ens-disk-available

オプション 2: 即時

1. 以下の内容で storage-class-csi.yaml というファイルを作成します。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: alicloud-ens-disk-available
   provisioner: ensplugin.csi.alibabacloud.com
   parameters:
     type: available
     regionId: <your-region-id>
   reclaimPolicy: Retain
   allowVolumeExpansion: false
   volumeBindingMode: Immediate

2. StorageClass を適用します。

   kubectl apply -f storage-class-csi.yaml

3. StorageClass が正しく作成されたことを確認します。

   kubectl get storageclass alicloud-ens-disk-available

StorageClass のパラメーター：

ステップ 2：PVC の作成

1. 以下の内容で pvc-dynamic.yaml というファイルを作成します。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: disk-pvc
   spec:
     accessModes:
     - ReadWriteOnce
     volumeMode: Filesystem
     resources:
       requests:
         storage: 25Gi
     storageClassName: alicloud-ens-disk-available

2. PVC を適用します。

   kubectl create -f pvc-dynamic.yaml

3. PVC のステータスを確認します。

   kubectl get pvc disk-pvc

   WaitForFirstConsumer を使用した場合、PVC は参照する Pod がスケジュールされるまで Pending 状態のままになります。これは正常な動作です。

ステップ 3：ワークロードのデプロイ

1. 以下の内容で pvc-dynamic-workload.yaml というファイルを作成します。

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: nginx-dynamic
   spec:
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: nginx
           ports:
           - containerPort: 80
             name: web
           volumeMounts:
           - name: pvc-disk
             mountPath: /tmp
         volumes:
           - name: pvc-disk
             persistentVolumeClaim:
               claimName: disk-pvc

   パラメーター	説明
   mountPath	コンテナ内でのディスクマウント先パス。
   claimName	マウントする PVC の名前。前のステップで作成した PVC の名前と一致させる必要があります。

2. StatefulSet を適用します。

   kubectl create -f pvc-dynamic-workload.yaml

3. Pod が実行中であり、PVC がバインドされていることを確認します。

   kubectl get pods -l app=nginx
   kubectl get pvc disk-pvc

   Pod がスケジュールされ、ディスクがプロビジョニングされると、PVC のステータスは Bound に変更されます。Pod のスケジューリングには数分かかる場合があります。

ステップ 1：PV の作成

1. 以下の内容で pv-static.yaml というファイルを作成します。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: csi-pv
     labels:
       alicloud-pvname: static-disk-pv
   spec:
     capacity:
       storage: 25Gi
     accessModes:
       - ReadWriteOnce
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: ensplugin.csi.alibabacloud.com
       volumeHandle: "<your-disk-id>"    # ご自身の ENS ディスク ID に置き換えてください
     nodeAffinity:
       required:
         nodeSelectorTerms:
         - matchExpressions:
           - key: topology.ensplugin.csi.alibabacloud.com/region
             operator: In
             values:
             - "<your-node-region-id>"  # 実行コマンド: kubectl get node <node-name> --show-labels

   パラメーター	説明
   volumeHandle	既存の ENS ディスクのディスク ID。Edge Node Service コンソールで確認できます。
   nodeAffinity	PV を指定リージョンのノードに制限します。ENS ディスクのリージョンに設定してください。
   topology.ensplugin.csi.alibabacloud.com/region	ENS ノードのリージョン ID。コマンド kubectl get node <node-name> --show-labels を実行して確認できます。

2. PV を適用します。

   kubectl create -f pv-static.yaml

3. PV が正しく作成されたことを確認します。

   kubectl get pv csi-pv

ステップ 2：PVC の作成

1. 以下の内容で pvc-static.yaml というファイルを作成します。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: csi-pvc
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 25Gi
     storageClassName: ""
     selector:
       matchLabels:
         alicloud-pvname: static-disk-pv

   storageClassName: "" は、Kubernetes に対して動的プロビジョニングではなく、手動で作成した PV にバインドするよう指示します。selector.matchLabels は PV のラベルと一致させる必要があります。要求するストレージ容量（25Gi）は、PV の容量を超えてはなりません。

2. PVC を適用します。

   kubectl create -f pvc-static.yaml

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

   kubectl get pvc csi-pvc

   PVC のステータスは Bound と表示されるはずです。

ステップ 3：ワークロードのデプロイ

1. 以下の内容で web-static.yaml というファイルを作成します。

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: nginx-static
   spec:
     selector:
       matchLabels:
         app: nginx
     serviceName: "nginx"
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: nginx
           ports:
           - containerPort: 80
             name: web
           volumeMounts:
           - name: pvc-disk
             mountPath: /tmp
         volumes:
           - name: pvc-disk
             persistentVolumeClaim:
               claimName: csi-pvc

2. StatefulSet を適用します。

   kubectl apply -f web-static.yaml

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

   kubectl get pods -l app=nginx
   kubectl get pvc csi-pvc

   Pod が Running ステータスになり、PVC が Bound と表示された場合、ENS ディスクが正常にマウントされています。