IBM Cloud Block Storage for VPC のクイック・スタート

このクイック・スタート・ガイドでは、ボリュームを動的にプロビジョニングするための PVC を作成することで、クラスタ内に 10Gi 5IOPS ティア Block Storage for VPC ボリュームを作成します。 その後、その PVC をマウントするアプリ・デプロイメントを作成します。

第2世代のストレージクラスを 選択できるようになった。

Block Storage for VPC ボリュームは、それらのポッドが同じノードでスケジュールされている限り、複数のポッドでマウントできます。

1. PVC のファイルを作成し、pvc.yaml という名前を付けます。 第 1 世代と第 2 世代の ストレージ クラスから選択します。

   ibmc-vpc-block-5iops-tier ストレージクラスを使用した第一世代の例：

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: my-pvc
   spec:
     storageClassName: ibmc-vpc-block-5iops-tier
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 10Gi
   

   ibmc-vpc-block-sdp ストレージクラスを使用した第二世代の例：

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: my-pvc
   spec:
     storageClassName: ibmc-vpc-block-sdp
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 10Gi
   

2. クラスター内に PVC を作成します。

   kubectl apply -f pvc.yaml
   

3. PVC をバインドしたら、その PVC を使用するアプリ・デプロイメントを作成します。 デプロイメントのファイルを作成し、deployment.yaml という名前を付けます。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
       name: my-deployment
       labels:
         app: my-app
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - image: ngnix # Your containerized app image.
           name: my-container
           volumeMounts:
           - name: my-volume
             mountPath: /mount-path
         volumes:
         - name: my-volume
           persistentVolumeClaim:
             claimName: my-pvc
   

4. クラスター内にデプロイメントを作成します。

   kubectl apply -f deployment.yaml
   

詳しくは、以下のリンクを参照してください。

• アプリへのBlock Storage for VPCの追加。
• ストレージ・クラス・リファレンス。
• デフォルトのストレージ設定のカスタマイズ。

アプリへの Block Storage for VPCの追加

Block Storage for VPCのプロファイルを選択し、Block Storage for VPCをクラスターに動的にプロビジョンするための永続ボリューム請求を作成します。 動的プロビジョニングでは、対応する永続ボリュームが自動的に作成され、お客様の IBM Cloud アカウントで物理ストレージ・デバイスが注文されます。

1. 容量とパフォーマンスの要件に最も適した Block Storage for VPCのプロファイルを決定します。

2. その Block Storage for VPCのプロファイルに対応するストレージ・クラスを選択します。

   IBM のすべての事前定義ストレージ・クラスは、デフォルトでは、ext4 ファイル・システムを使用して Block Storage for VPCをセットアップします。 xfs や ext3 などの別のファイル・システムを使用するには、カスタマイズしたストレージ・クラスを作成してください。

   • 10 IOPS/GB: ibmc-vpc-block-10iops-tier または ibmc-vpc-block-retain-10iops-tier
   • 5 IOPS/GB: ibmc-vpc-block-5iops-tier または ibmc-vpc-block-retain-5iops-tier
   • 3 IOPS/GB: ibmc-vpc-block-general-purpose または ibmc-vpc-block-retain-general-purpose
   • カスタム: ibmc-vpc-block-custom または ibmc-vpc-block-retain-custom

3. Block Storage for VPCの構成を決定します。

   1. ストレージのサイズを選択します。 選択した Block Storage for VPCのプロファイルでそのサイズがサポートされることを確認してください。
   2. クラスターまたは永続ボリューム請求 (PVC) が削除された後もデータを保持するかどうかを選択します。
      • データを保持する場合、retain ストレージ・クラスを選択します。 PVC を削除すると、PVC のみが削除されます。 永続ボリュームと、IBM Cloud アカウント内の物理ストレージ・デバイスと、データは残ります。 ストレージを回収し、クラスターで再使用するには、PV を削除し、既存の Block Storage for VPC を使用する手順に従う必要があります。
      • PVC を削除するときに PV、データ、物理 Block Storage for VPC デバイスが削除されるようにするには、retain なしのストレージ・クラスを選択します。

4. 永続ボリューム請求を定義した構成ファイルを作成し、YAML ファイルとして構成を保存します。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: <pvc_name> # Enter a name for your PVC.
   spec:
     accessModes:
     - <access-mode> # ReadWriteOnce or ReadWriteOncePod
     resources:
       requests:
         storage: 10Gi # Enter the size. Make sure that the size is supported in the profile that you chose.
     storageClassName: <storage_class> # Enter the storage class name that you selected earlier.
   

5. クラスター内に PVC を作成します。

   kubectl apply -f pvc.yaml
   

6. PVC が作成され、PV にバインドされたことを確認します。 この処理には数分かかる場合があります。

   kubectl describe pvc <pvc_name>
   

   出力例

   Name:          mypvv
   Namespace:     default
   StorageClass:  ibmc-vpc-block-5iops-tier
   Status:        Bound
   Volume:        
   Labels:        <none>
   Annotations:   kubectl.kubernetes.io/last-applied-configuration: {"apiVersion":"v1","kind":"PersistentVolumeClaim","metadata":{"annotations":{},"name":"csi-block-pvc-good","namespace":"default"},"spec":{...
               volume.beta.kubernetes.io/storage-provisioner: vpc.block.csi.ibm.io
   Finalizers:    [kubernetes.io/pvc-protection]
   Capacity: 10Gi   
   Access Modes:  
   VolumeMode:    Filesystem
   Events:
       Type       Reason                Age               From                         Message
       ----       ------                ----              ----                         -------
       Normal     ExternalProvisioning  9s (x3 over 18s)  persistentvolume-controller  waiting for a volume to be created, either by external provisioner "vpc.block.csi.ibm.io" or manually created by system administrator
   Mounted By:  <none>
   

7. アプリのデプロイメント構成ファイルを作成し、PVC をアプリにマウントします。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: <deployment_name>
     labels:
       app: <deployment_label>
   spec:
     selector:
       matchLabels:
         app: <app_name>
     template:
       metadata:
         labels:
           app: <app_name>
       spec:
         containers:
         - image: <image_name>
           name: <container_name>
           volumeMounts:
           - name: <volume_name>
             mountPath: /<file_path>
         volumes:
         - name: <volume_name>
           persistentVolumeClaim:
             claimName: <pvc_name>
   

   labels.app

   metadata セクションで、デプロイメントのラベルを入力します。

   matchLabels.app および labels.app

   spec の selector セクションおよび template の metadata セクションで、アプリのラベルを入力します。

   image

   使用するコンテナー・イメージの名前を指定します。 IBM Cloud Container Registry アカウント内の使用可能なイメージをリストするには、ibmcloud cr image-list を実行します。

   name

   ポッドにデプロイするコンテナーの名前を指定します。

   mountPath

   containers の volumeMounts セクションで、コンテナー内で PVC がマウントされるディレクトリーの絶対パスを指定します。

   name

   containers の volumeMounts セクションで、ポッドにマウントするボリュームの名前を入力します。 希望する名前を入力できます。

   name

   volumes セクションで、ポッドにマウントするボリュームの名前を入力します。 通常、この名前は volumeMounts.name と同じです。

   claimName

   volumes の persistentVolumeClaim セクションで、先ほど作成した PVC の名前を入力します。

8. クラスター内にデプロイメントを作成します。

   kubectl apply -f deployment.yaml
   

9. PVC がアプリに正常にマウントされていることを確認します。 ポッドが Running 状態になるまでに数分かかることがあります。

   アプリのデプロイメント中に、CLI 出力の Unable to mount volumesEvents** セクションに ** エラーが断続的に表示される場合があります。 Block Storage for VPC クラスターアドオンは、アプリへのストレージのマウントを自動的に再試行します。 ストレージがアプリにマウントされるまで数分待ってください。

   kubectl describe deployment <deployment_name>
   

   出力例

   ...
   Volumes:
   myvol:
       Type:    PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace)
       ClaimName:    mypvc
       ReadOnly:    false
   

既存の Block Storage for VPC・インスタンスの使用

クラスターで使用したい既存の物理 Block Storage for VPC デバイスがある場合は、PV と PVC を手動で作成して、そのストレージを静的にプロビジョンすることができます。

1 つのボリュームは 1 台のワーカー・ノードにのみ接続できます。 接続を成功させるために、ボリュームがワーカー・ノードと同じゾーンにあることを確認してください。

1. VPC クラスター内のワーカー・ノードに接続するボリュームを決定します。 ボリューム ID をメモします。

   ibmcloud is volumes
   

2. ボリュームの詳細をリストします。 サイズ、ゾーン、および IOPS をメモします。 これらの値を PV の作成に使用します。

   ibmcloud is volume <volume_id>
   

3. VPC クラスターのワーカー・ノードのリストを取得します。 ストレージ・ボリュームと同じゾーンにあるワーカー・ノードのゾーンをメモします。

   ibmcloud ks worker ls -c <cluster_name>
   

4. オプション: ストレージ・クラス retain を使用して物理 Block Storage for VPC・インスタンスをプロビジョンした場合は、PVC を削除しても、PV と物理ストレージは削除されません。 物理 Block Storage for VPC・デバイスをクラスターで使用するには、まず既存の PV を削除する必要があります。

   1. クラスター内の PV をリストし、Block Storage for VPC・デバイスに属する PV を探します。 PV は released 状態になっています。

      kubectl get pv
      

   2. PV を削除します。

      kubectl delete pv <pv_name>
      

5. PV の構成ファイルを作成します。 先ほど確認した ID、サイズ、ゾーン、IOPS を指定します。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: <pv_name> # Example: my-persistent-volume
   spec:
     accessModes:
     - ReadWriteOnce
     capacity:
       storage: <vpc_block_storage_size> # Example: 20Gi
     csi:
       driver: vpc.block.csi.ibm.io
       fsType: ext4
       volumeAttributes:
         iops: "<vpc_block_storage_iops>" # Example: "3000"
         volumeId: <vpc_block_storage_ID> # Example: a1a11a1a-a111-1111-1a11-1111a11a1a11
         zone: "<vpc_block_zone>" # Example: "eu-de-3"
         region: "<vpc_block_region>"
       volumeHandle: <vpc_block_storage_ID>
     nodeAffinity:
       required:
         nodeSelectorTerms:
         - matchExpressions:
           - key: failure-domain.beta.kubernetes.io/zone
             operator: In
             values:
             - <worker_node_zone> # Example: eu-de-3
           - key: failure-domain.beta.kubernetes.io/region
             operator: In
             values:
             - <worker_node_region> # Example: eu-de
           - key: kubernetes.io/hostname
             operator: In
             values:
             - <worker_node_primary_IP>
     persistentVolumeReclaimPolicy: Retain
     storageClassName: ""
     volumeMode: Filesystem
   

   name

   metadata セクションで、PV の名前を入力します。

   storage

   spec の capacity セクションで、先ほど確認したBlock Storage for VPC・ボリュームのサイズをギガバイト (Gi) 単位で入力します。 例えば、デバイスのサイズが 100 GB の場合は 100Gi と入力します。

   iops

   spec の csi の volumeAttributes セクションで、先ほど確認したBlock Storage for VPC・ボリュームの最大 IOPS を入力します。

   zone

   spec の csi の volumeAttributes セクションで、先ほど確認した場所と一致する VPC ブロック・ゾーンを入力します。 例えば、場所が Washington DC-1 の場合は、ゾーンとして us-east-1 を使用します。 使用可能なゾーンをリストするには、ibmcloud is zones を実行します。 使用可能な VPC ゾーンと場所の概要については、 別のリージョンでの VPC の作成を参照してください。 「zone」が指定されている場合は、「region」パラメーターを指定してください。

   region

   ストレージを接続する対象のワーカー・ノードのリージョン。

   worker_node_primary_IP

   ストレージの接続先となるワーカー・ノードの プライマリー IP。 ワーカー・ノードの プライマリー IP は、ibmcloud ks worker ls を実行して確認できます。

   volumeId および spec.csi.volumeHandle

   spec の csi の volumeAttributes セクションで、既に取得したBlock Storage for VPC・ボリュームの ID を入力します。

   storageClassName

   spec の storageClassName には、空の文字列を入力します。

   matchExpressions

   spec の nodeAffinity セクションで、ゾーンに一致するノード・セレクターの用語を入力します。 キーには failure-domain.beta.kubernetes.io/zone と入力します。 値には、ストレージを接続するワーカー・ノードのゾーンを入力します。

   matchExpressions

   spec の nodeAffinity セクションで、リージョンに一致するノード・セレクターの用語を入力します。 キーには failure-domain.beta.kubernetes.io/region と入力します。 値には、ストレージを接続するワーカー・ノードのリージョンを入力します。

6. クラスターに PV を作成します。

   kubectl apply -f pv.yaml
   

7. クラスター内に PV が作成されたことを確認します。

   kubectl get pv
   

8. 別の PVC 構成ファイルを作成します。 前の手順で作成した PV と一致する PVC にするために、ストレージ・サイズとアクセス・モードに同じ値を選択する必要があります。 ストレージ・クラスのフィールドには、PV と一致する空の文字列値を入力します。 これらのフィールドのいずれかがPVと一致しない場合、ダイナミック・プロビジョニングによって新しいPVと Block Storage for VPC インスタンスが自動的に作成される。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: <pvc_name>
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: <vpc_block_storage_size>
     storageClassName: ""
   

9. PVC を作成します。

   kubectl apply -f pvc.yaml
   

10. PVC が作成され、先ほど作成した PV にバインドされたことを確認します。 この処理には数分かかる場合があります。

kubectl describe pvc <pvc_name>

11. PVC を使用するデプロイメントまたはポッドを作成します。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: <deployment_name>
  labels:
    app: <deployment_label>
spec:
  selector:
    matchLabels:
      app: <app_name>
  template:
    metadata:
      labels:
        app: <app_name>
    spec:
      containers:
      - image: <image_name>
        name: <container_name>
        volumeMounts:
        - name: <volume_name>
          mountPath: /<file_path>
      volumes:
      - name: <volume_name>
        persistentVolumeClaim:
          claimName: <pvc_name>
      nodeSelector:
        kubernetes.io/hostname: "<worker_node_primary_IP>"

Block Storage for VPC クラスター・アドオンの更新

クラスタアドオン Block Storage for VPC は、コマンド addon update を使用して更新できます。

アドオンを更新する前に、変更ログを確認してください。

以前のリリースから「5.x リリースにアップデートする前に、「failure 状態のボリューム・スナップショットを持っていてはなりません。 詳細については、 「ボリューム スナップショット Block Storage for VPC リソースを削除できないのはなぜですか？」 を参照してください。

1. 更新が使用可能かどうかを確認します。 更新が使用可能な場合は、プラグインのバージョンにアスタリスクのフラグが付けられ、最新バージョンが表示されます。 最新バージョンの値を後で使用するのでメモしてください。

   ibmcloud ks cluster addons --cluster <cluster_name_or_ID>
   

   出力例

   Name                   Version                 Health State   Health Status   
   vpc-block-csi-driver   1.0.0* (2.0.0 latest)   normal         Addon Ready
   

2. アドオンを更新します。 更新コマンドは、インストールしたバージョンによって異なることに注意してください。

   5.0 以降 addon update コマンドを実行します。

   ibmcloud ks cluster addon update vpc-block-csi-driver --cluster CLUSTER [-f] [-q] [--version VERSION] [-y]
   

   バージョン 5.0 アドオンを無効にして有効にします。

   ibmcloud ks cluster addon disable vpc-block-csi-driver --cluster CLUSTER [-f] [-q]
   

   ibmcloud ks cluster addon enable vpc-block-csi-driver --cluster CLUSTER [-f] [-q] [--version VERSION] [-y]
   

3. アドオンがAddon Ready状態になったことを確認します。 アドオンの準備ができるまで数分かかる場合があります。

   ibmcloud ks cluster addon ls --cluster <cluster_name_or_ID>
   

   出力例

   Name                   Version   Health State   Health Status   
   vpc-block-csi-driver   2.0.0     normal         Addon Ready
   

   ibmc-vpc-block-10iops-tier ストレージ・クラス以外のデフォルト・ストレージ・クラスを使用する場合は、addon-vpc-block-csi-driver-configmap 構成マップのデフォルト・ストレージ・クラス設定を変更する必要があります。 詳しくは、デフォルト・ストレージ・クラスの変更を参照してください。

4. デフォルトの Block Storage for VPC ストレージ・クラスを基に独自のストレージ・クラスを作成した場合は、パラメータを更新するためにそれらのストレージ・クラスを再作成する必要があります。 詳細については、 バージョン 4.2 へのアップデート後の独自のストレージ・クラスの再作成を 参照してください。

Block Storage for VPC 用の暗号化のセットアップ

IBM® Key Protect などの鍵管理サービス (KMS) プロバイダーを使用して、ストレージに書き込まれるデータを暗号化するために Block Storage for VPC インスタンスで使用する秘密ルート鍵を作成します。 プライベート・ルート・キーを作成した後、ルート・キーを使用して独自のストレージ・クラスまたは Kubernetes シークレットを作成し、このストレージ・クラスまたはシークレットを使用して Block Storage for VPC インスタンスをプロビジョニングします。

暗号化を有効にすると、パフォーマンス Block Storage for VPC に約20%の影響を与えます。 ただし、正確な影響は、ワーカー・ノードとストレージ・ボリュームの構成によって異なります。 暗号化を有効にする際には、パフォーマンスへの影響を考慮してください。

1. 使用するKMSプロバイダーのインスタンスを作成する。

   • Key Protect.
   • Hyper Protect Crypto Services.

2. KMSインスタンスにルート・キーを作成する。

   • Key Protect ルート鍵。
   • Hyper Protect Crypto Services ルート鍵。 デフォルトでは、ルート・キーは有効期限なしで作成されます。

3. サービス間の認証を設定する。 Block Storage for VPCに IBM® Key Protect へのアクセスを許可します。 必ず与えてくださいBlock Storage for VPC少なくとも Reader KMS インスタンスへのアクセス。

4. カスタマイズ・ストレージ・クラスと Kubernetes シークレットのどちらに Key Protect ルート鍵 CRN を保管するかを決定します。 その後、手順に従って、カスタマイズ・ストレージ・クラスまたは Kubernetes シークレットを作成します。

   カスタマイズしたストレージ・クラスの例。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: <storage_class_name> # Enter a name for your storage class.
   provisioner: vpc.block.csi.ibm.io
   parameters:
     profile: "5iops-tier"
     csi.storage.k8s.io/fstype: "ext4"
     billingType: "hourly"
     encrypted: "true"
     encryptionKey: "<encryption_key>"
     resourceGroup: ""
     zone: ""
     tags: ""
     generation: "gc"
     classVersion: "1"
   reclaimPolicy: "Delete"
   

   encrypted

   パラメータに true と入力し、 Block Storage for VPC ボリュームに暗号化を設定するストレージクラスを作成します。 このオプションを true に設定する場合、 parameters.encryptionKey で使用する Key Protect サービスインスタンスのルートキーCRN を指定する必要があります。

   encryptionKey

   parameters で、先ほど確認したルート鍵 CRN を入力します。

   Kubernetes シークレットの例。

   apiVersion: v1
   kind: Secret
   type: vpc.block.csi.ibm.io
   metadata:
     name: <secret_name>
     namespace: <namespace_name>
   stringData:
     encrypted: <true_or_false>
   data
     encryptionKey: <encryption_key>
   

   name

   シークレットの名前を入力します。

   namespace

   シークレットを作成する名前空間を入力します。

   encrypted

   パラメータに true と入力し、 Block Storage for VPC ボリュームに暗号化を設定する。

   encryptionKey

   parameters で、Key Protect・ボリュームの暗号化に使用する Block Storage for VPC サービス・インスタンスのルート鍵 CRN を入力します。 シークレット内のルート・キー CRN を使用するには、まず echo -n "<root_key_CRN>" | base64 を実行して、それを base64 に変換する必要があります。

5. アプリへの Block Storage for VPCの追加の手順 4 から 9 までを実行して、カスタマイズしたストレージ・クラスの PVC を作成し、Block Storage for VPC ルート鍵を使用した暗号化を行うように構成された Key Protectをプロビジョンします。 その後、このストレージをアプリ・ポッドにマウントします。

   アプリがストレージをマウントして Running 状態になるまでに数分かかることがあります。

6. データが暗号化されていることを確認します。 Block Storage for VPC・ボリュームをリストし、作成したインスタンスの ID をメモします。 ストレージ・インスタンスの名前は、PVC の作成時に自動的に作成された PV 名と同じです。

   ibmcloud is vols
   

   出力例

   ID                                     Name                                       Status      Capacity   IOPS   Profile           Attachment type   Created                     Zone         Resource group
   a395b603-74bf-4703-8fcb-b68e0b4d6960   pvc-479d590f-ca72-4df2-a30a-0941fceeca42   available   10         3000   5iops-tier        data              2019-08-17T12:29:18-05:00   us-south-1   a8a12accd63b437bbd6d58fb6a462ca7
   

7. ボリューム ID を使用して、Block Storage for VPC・インスタンスに関する詳細をリストし、Key Protect ルート鍵がストレージ・インスタンス内に保管されていることを確認します。 ルート鍵は、CLI 出力の Encryption key フィールドで確認できます。

   ibmcloud is vol <volume_ID>
   

   出力例

   ID                                     a395b603-74bf-4703-8fcb-b68e0b4d6960   
   Name                                   pvc-479d590f-ca72-4df2-a30a-0941fceeca42   
   Status                                 available   
   Capacity                               10   
   IOPS                                   3000   
   Profile                                5iops-tier   
   Encryption key                         crn:v1:bluemix:public:kms:us-south:a/6ef045fd2b43266cfe8e6388dd2ec098:53369322-958b-421c-911a-c9ae8d5156d1:key:47a985d1-5f5e-4477-93fc-12ce9bae343f   
   Encryption                             user_managed   
   Resource group                         a8a12accd63b437bbd6d58fb6a462ca7
   Created                                2019-08-17T12:29:18-05:00
   Zone                                   us-south-1   
   Volume Attachment Instance Reference
   

デフォルトのストレージ設定のカスタマイズ

カスタマイズしたストレージ・クラスまたは Kubernetes シークレットを使用して、カスタマイズした設定で Block Storage for VPC を作成することにより、いくつかのデフォルト PVC 設定を変更できます。

シークレットを使用し、カスタマイズされたストレージクラスでパラメータを指定する利点は何ですか？

クラスター管理者として、クラスター・ユーザーが作成するすべての PVC を特定の構成でプロビジョンし、クラスター・ユーザーがデフォルト構成を上書きできないようにする場合は、カスタマイズ・ストレージ・クラスの作成。

ただし、複数の構成が必要な場合、カスタマイズ・ストレージ・クラスをすべての PVC 構成事例ごとに作成することを避けるために、カスタマイズ・ストレージ・クラスを 1 つ作成して、その中にデフォルトの PVC 設定と、汎用 Kubernetes シークレットへの参照を組み込むことができます。 カスタマイズ・ストレージ・クラスのデフォルト設定をクラスター・ユーザーがオーバーライドする必要がある場合は、独自のカスタム設定を保持する Kubernetes シークレットをクラスター・ユーザーが自分で作成することができます。

クラスター管理者がBlock Storage for VPC・インスタンスの暗号化をセットアップするとき、Key Protect ルート鍵 CRN を base64 にエンコードする場合には、カスタマイズ・ストレージ・クラス内で鍵を直接提供する代わりに、Kubernetes シークレットを使用することもできます。

ボリューム拡張のセットアップ

拡張をサポートするボリュームをプロビジョニングするには、allowVolumeExpansion が true に設定されているストレージ・クラスを使用する必要があります。

拡張できるのは、アプリ・ポッドによってマウントされたボリュームのみです。

アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。

1. バージョン 4.2 以降のアドオンを使用していない場合は、 クラスタの Block Storage for VPC クラスタ・アドオンを更新して ください。

2. ボリューム拡張をサポートするストレージ・クラスを使用する PVC を作成します。

3. PVC を使用するアプリをデプロイします。 アプリの作成時に、指定した mountPath をメモします。

4. PVC がアプリ・ポッドによってマウントされた後、PVC の spec.resources.requests.storage フィールドの値を編集して、ボリュームを拡張できます。 ボリュームを拡張するには、PVC を編集して、spec.resources.requests.storage フィールドの値を大きくします。

   kubectl edit pvc <pvc-name>
   

   例

   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 10Gi
   

5. PVC を保存して閉じます。

6. オプション: ボリュームが拡張されたことを確認します。 PVC の詳細を取得し、PV 名をメモします。

   kubectl get pvc <pvc-name>
   

7. PV の詳細を表示し、ボリューム ID をメモします。

   kubectl describe PV
   

8. Block Storage for VPC ボリュームの詳細を取得し、容量を確認します。

   ibmcloud is vol <volume-ID>
   

データのバックアップと復元

Block Storage for VPC 上のデータは、リージョン内の対障害冗長化ゾーンに分散されて保護されます。 データを手動でバックアップするには、Kubernetes kubectl cp コマンドを使用します。

kubectl cp コマンドを使うと、クラスタ内のポッドや特定のコンテナとの間でファイルやディレクトリをコピーできます

始める前に: アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。

データのバックアップまたはリストアを行うには、以下の選択肢があります。

ローカル・マシンからクラスター内のポッドにデータをコピーする。

kubectl cp <local_filepath>/<filename> <namespace>/<pod>:<pod_filepath>

クラスター内のポッドからローカル・マシンにデータをコピーする。

kubectl cp <namespace>/<pod>:<pod_filepath>/<filename> <local_filepath>/<filename>

ローカル・マシンからクラスター内のポッドで実行される特定のコンテナーにデータをコピーする。

kubectl cp <local_filepath>/<filename> <namespace>/<pod>:<pod_filepath> -c CONTAINER

ボリューム要求容量について

VPC ブロック CSI ドライバーは、以下の数式を使用してボリューム容量を計算します。

• 値が提供される場合 Gi:rBytes(requestedBytes） = X * 1024^3

• 値が提供される場合 G:rBytes(requestedBytes） = X * 10^9

要求された値は (((rBytes+ GiB - 1) / GiB) * GiB) / GiB に等しくなります。

以下に例を示します。

• 値 20Gi が指定されている場合、上記の数式を適用すると、作成されるボリュームは 20GB になります。
• 値 20G が指定された場合、作成されるボリュームは 19GB です。

場合によっては、作成されたボリュームの容量が、要求された値より小さいことがあります。 請求は、要求されたボリュームではなく、作成されたボリュームに適用されることに注意してください。

ブロック・ストレージに信頼されたプロファイルを割り当てる

既知の問題により、信頼済みプロファイルが実装されている場合、VPC Block Storage ボリューム上のユーザータグの更新が表示されない可能性があります。 この問題は、信頼されたプロファイルを使用しないクラスタでは発生しません。

信頼されたプロファイルを使用して、異なる IBM Cloud ID に、ストレージソリューションを含むアカウント内のリソースへのアクセスを許可することができます。 信頼されたプロファイルは、アクセス制御を一元化し、長期間のAPIキーの必要性を排除し、特定のタスクに必要な最小限のパーミッションをスコープすることを可能にする。 詳細については、 ストレージコンポーネントの信頼済みプロファイルの構成を 参照してください。