Container Compute Service:静的にプロビジョニングされた OSS ボリュームのマウント

ステップ 1: PV の作成

1. 次の YAML コンテンツを oss-pv.yaml として保存します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: oss-secret
     namespace: default
   stringData:
     akId: <お使いの AccessKey ID>
     akSecret: <お使いの AccessKey Secret>
   ---
   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: oss-pv
     labels:
       alicloud-pvname: oss-pv
   spec:
     storageClassName: test 
     capacity:
       storage: 20Gi
     accessModes:
       - ReadWriteMany
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: ossplugin.csi.alibabacloud.com
       volumeHandle: oss-pv
       nodePublishSecretRef:
         name: oss-secret
         namespace: default
       volumeAttributes:
         fuseType: ossfs2 # ossfs 2.0 クライアントの使用を明示的に宣言します
         bucket: "<お使いの OSS バケット名>"
         url: "<お使いの OSS バケットのエンドポイント>"
         otherOpts: "-o close_to_open=false" # 注: サポートされているマウントパラメーターは、ossfs 1.0 クライアントと互換性がありません。

   説明

   上記の YAML は、シークレットと PV を作成します。シークレットには、PV が安全に使用するための AccessKey ペアが格納されます。akId の値を AccessKey ID に、akSecret の値を AccessKey Secret に置き換えてください。

   次の表に、PV パラメーターを示します。

   パラメーター	説明
   alicloud-pvname	PV のラベル。PVC をバインドするために使用されます。
   storageClassName	この設定は PVC をバインドするためにのみ使用されます。実際の StorageClass を関連付ける必要はありません。
   storage	OSS ボリュームのストレージ容量。 説明 静的にプロビジョニングされた OSS ボリュームの容量は宣言のみを目的としています。実際の容量は制限されません。利用可能な容量は、OSS コンソールに表示される量に従います。
   accessModes	アクセスモード。
   persistentVolumeReclaimPolicy	再利用ポリシー。
   driver	ドライバーのタイプ。ここでは、ossplugin.csi.alibabacloud.com に設定されており、Alibaba Cloud OSS CSI プラグインが使用されることを示します。
   volumeHandle	PV の一意の識別子。metadata.name と一致する必要があります。
   nodePublishSecretRef	指定されたシークレットから AccessKey ペアを取得して権限付与を行います。
   fuseType	マウントに使用するクライアントを指定します。ossfs 2.0 クライアントを使用するには、ossfs2 に設定する必要があります。
   bucket	OSS バケットの名前。bucket の値を実際の OSS バケット名に置き換えてください。
   url	OSS バケットのエンドポイント。url の値を実際の OSS バケットのエンドポイントに置き換えてください。 OSS バケットと ACS クラスターが同じリージョンにある場合は、VPC エンドポイントを使用します。例: oss-cn-shanghai-internal.aliyuncs.com。 バケットがリージョンに依存しないか、ACS クラスターとは異なるリージョンにある場合は、パブリックエンドポイントを使用します。例: oss-cn-shanghai.aliyuncs.com。
   otherOpts	-o *** -o *** 形式で OSS ボリュームのカスタムパラメーターを入力します。例: -o close_to_open=false。 close_to_open: デフォルトで無効になっています。有効にすると、ファイルが開かれるたびにシステムが GetObjectMeta リクエストを OSS に送信し、OSS 内のファイルの最新のメタデータを取得します。これにより、リアルタイムのメタデータが保証されます。ただし、多くの小さなファイルを読み取る必要があるシナリオでは、頻繁なメタデータクエリによりアクセスレイテンシーが大幅に増加します。 オプションパラメーターの詳細については、「ossfs 2.0 マウントオプション」をご参照ください。

2. 次のコマンドを実行して、シークレットと PV を作成します。

   kubectl create -f oss-pv.yaml

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

   kubectl get pv

   期待される出力:

   NAME     CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM   STORAGECLASS   VOLUMEATTRIBUTESCLASS   REASON   AGE
   oss-pv   20Gi       RWX            Retain           Available           test           <unset>                          9s

ステップ 2: PVC の作成

1. 次の YAML コンテンツを oss-pvc.yaml として保存します。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: oss-pvc
   spec:
     storageClassName: test
     accessModes:
       - ReadWriteMany
     resources:
       requests:
         storage: 20Gi
     selector:
       matchLabels:
         alicloud-pvname: oss-pv

   パラメーターは次の表で説明されています。

   パラメーター	説明
   storageClassName	この設定は PVC をバインドするためにのみ使用されます。実際の StorageClass を関連付ける必要はありません。PV の spec.storageClassName と一致する必要があります。
   accessModes	アクセスモード。
   storage	Pod に割り当てられるストレージ容量。OSS ボリュームの容量を超えることはできません。
   alicloud-pvname	バインドする PV のラベル。PV の metadata.labels.alicloud-pvname と一致する必要があります。

2. PVC を作成できます。

   kubectl create -f oss-pvc.yaml

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

   kubectl get pvc

   次の出力は、PVC がステップ 1 で作成した PV にバインドされていることを示しています。

   NAME      STATUS   VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
   oss-pvc   Bound    oss-pv   20Gi       RWX            test           <unset>                 6s

ステップ 3: アプリケーションの作成と OSS ボリュームのマウント

1. 次の YAML コンテンツを oss-test.yaml として保存します。

   次の YAML の例では、2 つの Pod を持つデプロイメントを作成します。両方の Pod は、oss-pvc という名前の PVC を使用してストレージリソースを要求します。両方のマウントパスは /data です。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: oss-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: pvc-oss
               mountPath: /data
         volumes:
           - name: pvc-oss
             persistentVolumeClaim:
               claimName: oss-pvc

2. 次のコマンドを実行して、デプロイメントを作成し、OSS ボリュームをマウントします。

   kubectl create -f oss-test.yaml

3. デプロイメント内の Pod のステータスを確認します。

   kubectl get pod | grep oss-test

   次の出力例は、2 つの Pod が作成されたことを示しています。

   oss-test-****-***a   1/1     Running   0          28s
   oss-test-****-***b   1/1     Running   0          28s

4. マウントパスを表示します。

   次のコマンドは一例です。デフォルトでは、ディレクトリは空であり、出力は返されません。

   kubectl exec oss-test-****-***a -- ls /data