IBM Cloud Block Storage Attacher プラグインの更新

既存の IBM Cloud Block Storage Attacher プラグインを最新バージョンにアップグレードできます。

1. Helm リポジトリーを更新して、このリポジトリーにあるすべての Helm チャートの最新バージョンを取得します。

   helm repo update
   

2. オプション: 最新の Helm チャートをローカル・マシンにダウンロードします。 そして、パッケージを解凍し、release.md ファイルを参照して最新リリース情報を確認します。

   helm pull iks-charts/ibmcloud-block-storage-plugin
   

3. IBM Cloud Block Storage Attacher プラグインの Helm チャートの名前を確認します。

   helm ls -A
   

   出力例

   <helm_chart_name>    1           Wed Aug  1 14:55:15 2022    DEPLOYED    ibm-block-storage-attacher-1.0.0    default
   

4. IBM Cloud Block Storage Attacher を最新バージョンにアップグレードします。

   helm upgrade --force --recreate-pods <helm_chart_name> ibm-block-storage-attacher
   

IBM Cloud Block Volume Attacher プラグインの削除

クラスター内で IBM Cloud Block Storage Attacher プラグインをプロビジョンも使用もしない場合は、Helm チャートをアンインストールできます。

1. IBM Cloud Block Storage Attacher プラグインの Helm チャートの名前を確認します。

   helm list | grep ibm-block-storage-attacher
   

   出力例

   <helm_chart_name>    1           Wed Aug  1 14:55:15 2022    DEPLOYED    ibm-block-storage-attacher-1.0.0    default
   

2. Helm チャートを削除することで、IBM Cloud Block Storage Attacher プラグインを削除します。

   helm uninstall <helm_chart_name> -n <namespace>
   

3. IBM Cloud Block Storage Attacher プラグインのポッドが削除されたことを確認します。

   oc get pod -n kube-system -o wide | grep attacher
   

   CLI 出力にポッドが表示されていなければ、ポッドは正常に削除されています。

4. IBM Cloud Block Storage Attacher のストレージ・クラスが削除されたことを確認します。

   oc get sc | grep attacher
   

ストレージ・クラスが正常に削除された場合は、CLI 出力にストレージ・クラスが表示されません。

API を使用した VPC クラスター内のワーカー・ノードからの未フォーマットのロー Block Storage for Classic の切り離し

DELETE 要求を使用して、VPC ワーカー・ノードからストレージを切断できます。

VPC クラスターからストレージを切断しても、Block Storage for Classic ボリュームやそのボリュームに保管されているデータは削除されません。 ボリュームを手動で削除するまで、料金がかかります。

1. 削除するストレージボリュームを特定し、そのボリュームIDをメモしておきます。

   ibmcloud is volumes
   

2. ボリュームについての詳細を取得します。 このコマンドは、ワーカー・ノード ID および接続 ID を戻します。 ワーカー・ノード ID をメモしてください。 次のコマンドで、この ID は「インスタンス名」として返されます。

   ibmcloud is volume <volume_ID>
   

3. PV のリストを取得します。 このコマンドは、削除するボリュームを使用しているPVCを特定するために利用できる、PVのリストを返します。

   oc get pv
   

4. ボリュームを使用している PV の詳細を表示します。 どのPVのボリュームを削除すべきかわからない場合は、クラスタ内の各PVに対して describe pv コマンドを実行してください。 PV を使用している PVC をメモします。

   oc describe pv <pv_name>
   

5. ストレージ・ボリュームがポッドで使用されているかどうかを確認します。 次のコマンドは、ボリュームをマウントするポッド、および関連付けられている PVC を表示します。 ポッドが返されない場合、ストレージは使用されていません。

   oc get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>"
   

6. ボリュームを使用しているポッドがデプロイメントに含まれている場合は、そのデプロイメントを削除します。 ポッドがデプロイメントに含まれていない場合は、ポッドを削除します。

   oc delete deployment <deployment_name>
   

   oc delete pod <pod_name>
   

7. PVC および PV を削除します。

   oc delete pvc <pvc_name>
   

   oc delete pv <pv_name>
   

8. IAM トークンを取得します。

   ibmcloud iam oauth-tokens
   

9. POST 要求を使用して、ストレージを切り離します。

   要求の例

   curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/deleteAttachment" -H  "accept: application/json" -H  "Authorization: <IAM_token>" -H  "X-Auth-Resource-Group-ID: <resource_group>" -H  "Content-Type: application/json" -d "{  \"cluster\": \"<cluster_name_or_ID\",  \"volumeAttachmentID\": \"<volume_attachment_ID>\",  \"volumeID\": \"<volume_ID>\",  \"worker\": \"<worker_ID>\"}"
   

   IAM_token

   現行セッションの IAM OAuth トークン。 この値は、ibmcloud iam oauth-tokens を実行して取得できます。

   cluster_name_or_ID

   クラスターに割り当てられている固有 ID または名前。 この ID は、ibmcloud oc cluster ls を実行することによって取得できます。

   worker_ID

   ボリュームを接続するワーカー・ノードに割り当てられている固有 ID。 この値は、ibmcloud oc worker ls -c CLUSTER_NAME を実行して取得できます。

   volume_ID

   Block Storage for Classic ボリュームに割り当てられている固有 ID。 ibmcloud is volumes を実行して、Block Storage for Classic ボリュームのリストを取得できます。

   volume_attachment_ID

   ボリューム接続に割り当てられている固有 ID。 この ID は、ibmcloud is volume <volume_ID> を実行することによって取得できます。

API を使用した VPC ワーカー・ノードのボリューム接続の詳細の確認

GET 要求を使用して、VPC ワーカー・ノードのボリューム接続の詳細を取得できます。

1. IAM トークンを取得します。

   ibmcloud iam oauth-tokens
   

2. クラスターがデプロイされているリソース・グループの ID を取得します。

   ibmcloud oc cluster get CLUSTER_NAME_OR_ID | grep "Resource Group ID"
   

3. ボリューム接続の詳細を表示するワーカー・ノードの ID を取得します。 Block Storage for Classic インスタンスと同じゾーンにあるワーカーノードを必ず選択してください。

   ibmcloud oc worker ls --cluster CLUSTER_NAME_OR_ID
   

4. ワーカー・ノードの既存のボリューム接続のリストを確認します。

   curl -X GET "https://containers.cloud.ibm.com/v2/storage/getAttachments?cluster=<cluster_ID>&worker=<worker_ID>" --header "X-Auth-Resource-Group-ID: <resource_group_ID>" --header "Authorization: <IAM_token>"
   

5. 特定の接続の詳細を取得します。

   curl -X GET "https://containers.cloud.ibm.com/v2/storage/getAttachment?cluster=<cluster_ID>&worker=<worker_ID>&volumeAttachmentID=<volume_attachment_ID>" --header "X-Auth-Resource-Group-ID: <resource_group_ID>" --header "Authorization: <IAM_token>"
   

   IAM_token

   現行セッションの IAM OAuth トークン。 この値は、ibmcloud iam oauth-tokens を実行して取得できます。

   cluster_ID

   クラスターに割り当てられている固有 ID。 この ID は、ibmcloud oc cluster ls を実行することによって取得できます。

   worker_ID

   ボリュームを接続するワーカー・ノードに割り当てられている固有 ID。 この値は、ibmcloud oc worker ls -c CLUSTER_NAME を実行して取得できます。

   volume_ID

   Block Storage for Classic ボリュームに割り当てられている固有 ID。 ibmcloud is volumes を実行して、Block Storage for Classic ボリュームのリストを取得できます。

   volume_attachment_ID

   ボリューム接続に割り当てられている固有 ID。 この ID は、ibmcloud is volume <volume_ID> を実行することによって取得できます。

CLI を使用した VPC ワーカー・ノードからのロー Block Storage for VPC の削除

ibmcloud oc storage attachment rm コマンドを使用して、ワーカー・ノードからストレージを取り外すことができます。

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

1. 使用中のストレージボリュームの一覧を表示し、削除するボリュームのIDを確認してください。

   ibmcloud is vols
   

2. ボリュームを接続するボリュームの詳細 (worker-id など) を取得します。 worker-id が、コマンド出力の Volume Attachment Instance Reference セクションの Instance name としてリストされます。

   ibmcloud is vol <volume-ID>
   

   出力例

   Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name                                        Auto delete   Attachment ID                               Attachment name      
                                       data              0727_e18c10d7-7f18-48aa-b5ef-5ed163e54198   kube-bsaucubd07dhl66e4tgg-cluster-default-00000a19   false         0727-3bfe90b0-dc2d-498a-946b-8837a5dad7bc   volume-attachment
   

3. クラスター内のワーカー・ノード上のストレージ接続をリストし、削除する接続 ID をメモします。

   ibmcloud oc storage attachment ls -c CLUSTER --worker WORKER_ID
   

   出力例:

   Listing volume attachments...
   OK
   ID                                          Name                Status     Type   Volume ID                                   Volume Name                          Worker ID   
   0111-1a111aaa-1111-1111-111a-aaa1a1a11a11   volume-attachment   attached   boot   a001-f11ed1e1-1aa1-11dc-b11d-a0dc111b1111  dissuade-anointer-errand-handbrake   kube-aa1111aa11aaaaa11aa1-cluster-name-default-00000110
   

4. ストレージ接続を削除します。

   ibmcloud oc storage attachment rm --attachment ATTACHMENT_ID -c CLUSTER --worker WORKER_ID
   

5. ストレージがワーカー・ノードから削除されたことを確認します。

   ibmcloud oc storage attachment ls -c CLUSTER_ID --worker WORKER_ID
   

IBM Cloud Object Storage サービス・インスタンスのセットアップ

バックアップ対象データの保存先となる IBM Cloud Object Storage サービスインスタンスを作成し、設定を行います。

1. HMAC 資格情報を使用する IBM Cloud Object Storage サービス・インスタンスを作成します。
2. IBM Cloud Object Storage 資格情報を Kubernetes シークレットに保管します。
3. 最初の IBM Cloud Object Storage バケットを作成します。
   1. サービス詳細ページのナビゲーションで、**「バケット」**をクリックします。
   2. 「バケットの作成」 をクリックします。 ダイアログ・ボックスが表示されます。
   3. バケットに対する固有の名前を入力します。 この名前は、IBM Cloud Object Storage 内で、すべてのリージョンおよびすべての IBM Cloud アカウントにわたって固有でなければなりません。
   4. 「Resiliency 」リストから、データの可用性レベルを選択してください。 詳しくは、IBM Cloud Object Storage のリージョンとエンドポイントを参照してください。 VPC クラスターの場合は、直接エンドポイントをメモします。 例えば、s3.direct.us.cloud-object-storage.appdomain.cloud などです。
   5. データを保存している地域に場所を変更してください。 法律上の理由により、データをすべてのリージョンで保管できるとは限らないことに注意してください。
   6. 「作成」 をクリックします。
4. バケットの IBM Cloud Object Storage ホスト名を取得します。
   1. 前の手順で作成したバケット名をクリックしてください。
   2. サービス詳細ページのナビゲーションで、「 バケット 」＞「 構成 」をクリックします。
   3. バケットのデータにアクセスするためのパブリック URL をメモします。

サービス・インスタンスの構成について詳しくは、IBM Cloud Object Storage 資料を参照してください。

IBM Cloud Object Storage を使用した PVC データのバックアップおよびリストア

IBM Cloud Backup Restore Helm チャートを使用して、ファイル・ストレージまたはブロック・ストレージの PVC のデータを IBM Cloud Object Storage にバックアップしたり、IBM Cloud Object Storage にあるデータをクラスター内の PVC にリストアしたりできます。

始める前に

• データのバックアップや復元を行うためのPVCが用意されていることを確認してください。 PVC の作成方法について詳しくは、ファイル・ストレージをアプリに追加するおよびアプリへのブロック・ストレージの追加を参照してください。

• ブロックストレージのPVCをバックアップするには、そのPVCがアプリにマウントされていないことを確認してください。 ブロック・ストレージは、RWO アクセス・モードでマウントされます。 このアクセスでは、一度に 1 つのポッドしかブロック・ストレージにマウントできません。 データをバックアップするには、ストレージをマウントするアプリ・ポッドを削除する必要があります。 PVC がポッドにマウントされているかどうかを調べるには、次のコマンドを実行します。

  oc get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>"
  

• IBM Cloud Object Storage サービス資格情報、バケット名、およびバケットのホスト名を取得します。

• こちらの手順に従って、ローカル・マシンに Helm クライアントをインストールし、IBM Cloud Helm チャート・リポジトリーをセットアップします。

• Red Hat OpenShift クラスターにアクセスします。

Helm チャートの ibm-storage-backup ファイルを編集して適用するか、CLI から ibm-storage-restore コマンドを実行して、 values.yaml ポッドまたは helm install ポッドをデプロイできます。

values.yaml ファイルを編集して PVC をバックアップまたはリストアするには、以下のようにします。

1. 最新のバージョンの Helm チャートをローカル・マシンにダウンロードします。

   helm fetch --untar iks-charts/ibmcloud-backup-restore
   

2. nano のコマンドラインエディタで、 values.yaml ファイルを開きます。

   nano ibmcloud-backup-restore/values.yaml
   

3. PVC データをバックアップまたはリストアするように、Helm チャートを構成します。 複数の PVC のバックアップを構成できます。

   values.yaml ファイルを構成してバックアップ・ポッドを作成する例:

   image:
       repository: icr.io/iks-charts/ibmcloud-backup-restore
   pullPolicy: Always
   tag: latest
   ACCESS_KEY_ID: # Example: 10110abab1111bbb111aa1aaa111b1a1
   SECRET_ACCESS_KEY: # Example: a1aba11aaa11b11b11aa1111a1111ba111111111a0b1b11a
   ENDPOINT: # Example: s3.us-east.cloud-object-storage.appdomain.cloud
   BUCKET_NAME: # Example: my-bucket
   BACKUP_NAME: # Example: my_backup
   PVC_NAMES:
       - # Example: my_pvc
   - # Optional example: my_pvc2
   CHART_TYPE: # Example: backup or restore
   BACKUP_TYPE: # Example: incremental
   SCHEDULE_TYPE: # Example: periodic
   SCHEDULE_INFO: # Example: weekly
   

   ACCESS_KEY_ID

   先ほど取得した IBM Cloud Object Storage サービス資格情報のアクセス・キー ID を入力します。

   SECRET_ACCESS_KEY

   先ほど取得した IBM Cloud Object Storage サービス資格情報のシークレットのアクセス・キーを入力します。

   ENDPOINT

   先ほど取得したバケットのパブリック IBM Cloud Object Storage s3 API エンドポイントを入力します。

   BUCKET_NAME

   バックアップ: 先ほど作成した IBM Cloud Object Storage バケットの名前を入力します。 このバケットが、バックアップの実行時に PVC データを保管するために使用されます。 リストア: バックアップが保管されている IBM Cloud Object Storage バケットの名前を入力します。

   BACKUP_NAME

   バックアップ: IBM Cloud Object Storage に作成するバックアップの名前を入力します。 リストア: IBM Cloud Backup Restore Helm チャートを使用して IBM Cloud Object Storage に作成したバックアップの名前を入力します。 IBM Cloud Object Storage サービス・インスタンスに複数のフルバックアップが存在する場合は、PVC は最後のフルバックアップのデータを使用して復元されます。 増分バックアップが存在する場合は、PVC は、復元を開始した日までのすべての増分バックアップを含む、最後のフルバックアップのデータを使用して復元されます。

   PVC_NAMES

   バックアップ ：バックアップするPVCの名前を入力してください。 複数のPVCをバックアップするには、各PVCをPVCのリストに追加してください。 クラスター内に存在するバックアップ可能な PVC をリストするには、oc get pvc を実行します。 復元 ： IBM Cloud Object Storage からデータを復元するPVCの名前を入力してください。 一度に 1 つの PVC だけにデータをリストアできます。 クラスター内に存在する、データをリストア可能な PVC をリストするには、oc get pvc を実行します。

   CHART_TYPE

   展開するグラフの種類を入力してください。 バックアップ・チャートをデプロイするには、backup と入力します。 リストア・チャートをデプロイするには、restore と入力します。

   BACKUP_TYPE

   バックアップの場合にのみ必要です。 full と入力して完全バックアップを作成するか、 incremental と入力して新規または変更されたファイルのみをバックアップします。 incremental を選択した場合は、SCHEDULING_INFO および SCHEDULING_TYPE オプションを指定する必要があります。 BACKUP_TYPE オプションを指定しない場合、デフォルトでフルバックアップが作成されます。

   SCHEDULE_TYPE

   バックアップの場合にのみ必要です。 スケジュールされたバックアップを作成するには、periodic を入力します。1 回限りのバックアップを作成するには、このオプションを空のままにします。 定期的なバックアップを作成するには、「 SCHEDULE_INFO 」オプションでバックアップ間隔を指定する必要があります。

   SCHEDULE_INFO

   バックアップの場合にのみ必要です。 定期的なバックアップを作成するには、バックアップのスケジュールを決定する必要があります。 hourly、daily、または weekly のいずれかを選択します。 このオプションを設定する場合は、SCHEDULE_TYPE を periodic に設定する必要があります。

4. values.yaml ファイルを保存して閉じます。

5. values.yaml ファイルのカスタム設定を使用して、Helm チャートをインストールします。 Helm チャートをインストールしてバックアップまたはリストアを構成すると、ibm-storage-backup ポッドまたは ibm-storage-restore ポッドがクラスターにデプロイされます。 バックアップ・ポッドは PVC のデータを IBM Cloud Object Storage にバックアップし、リストア・ポッドはデータを PVC にリストアします。 <release_name> を Helm チャートの名前に置き換えます。 バックアップ・ポッドとリストア・ポッドは、バックアップまたはリストアを実行する PVC と同じゾーンにインストールしてください。

   • helm install コマンドを使用して Helm チャートをインストールします。

       helm install <release_name> ./ibmcloud-backup-restore -n <namespace>
       ```
       バックアップの出力例:
   
       ```sh {: screen}
       NAME: <release_name>
       LAST DEPLOYED: Mon Jan 20 09:17:02 2020
       NAMESPACE: default
       STATUS: deployed
       REVISION: 1
       TEST SUITE: None
       NOTES:
       Thank you for installing: ibmcloud-backup-restore.   Your release is named: <release_name>
       Please refer Chart README.md file for creating a sample PVC
       Please refer Chart RELEASE.md to see the release details/fixes
       ```
   * オプション： `helm install` コマンドでオプションを設定し、 Helm チャートをインストールします。 `--name` パラメーターを指定してリリースに名前を付けることができます。
   ```sh {: pre}
       helm install <release_name> --set ACCESS_KEY_ID=<access_key_ID> --set SECRET_ACCESS_KEY=<secret_access_key> --set ENDPOINT=<public_bucket_endpoint> --set BUCKET_NAME=<bucket_name> --set BACKUP_NAME=<backup_name> --set PVC_NAMES[0]=<pvc_name1> --set PVC_NAMES[1]=<pvc_name2> --set CHART_TYPE=backup --set BACKUP_TYPE=<backup_type> --set SCHEDULE_TYPE=<schedule_type> --set SCHEDULE_INFO=<schedule_info> ./ibmcloud-backup-restore
       ```
   

6. データのバックアップまたはリストアが正常に完了したことを確認します。

バックアップ: 1. ibm-storage-backup ポッドの状況が Running になっていることを確認します。 sh {: pre} oc get pods -A | grep backup 出力例

    ```sh {: screen}
    ibm-storage-backup                        1/1     Running             0          64m
    ```
2. `ibm-storage-backup` ポッドのログを参照して、バックアップが成功したことを確認します。 ログに「 `... backup completed` 」というメッセージが表示されたら、バックアップは正常に完了しています。

```sh {: pre}
    oc logs ibm-storage-backup
    ```
    日次バックアップの出力例。

    ```sh {: screen}
    [2019-04-18 16:01:51,157] [utilities : 151] [INFO] *****************Start logging to ./Backup.log
    [2019-04-18 16:01:51,158] [backup : 48] [INFO] Starting backup:
    [2019-04-18 16:01:51,158] [configureOS : 66] [INFO] Configuring duplicity with IBM CloudObjectStorage i.e s3.
    [2019-04-18 16:01:51,158] [backup : 62] [INFO] Configuration done!!!
    [2019-04-18 16:01:51,158] [backup : 78] [INFO] Got all required input from config file!!
    [2019-04-18 16:01:52,366] [backup : 119] [WARNING] Incremental backup was not created
    [2019-04-18 16:01:52,366] [backup : 120] [INFO] duplicity  --no-encryption incremental /myvol s3://s3.us-south.cloud-object-storage.appdomain.cloud/mybucket/helm-backup command failed due to Fatal Error: Unable to start incremental backup.  Old signatures not found and incremental specified
    [2019-04-18 16:01:52,367] [backup : 121] [INFO] A full backup is required before incremental backups can begin. Creating a one-time full backup and will run incremental backups for scheduled backups.
    [2019-04-18 16:01:54,357] [backup : 129] [INFO] Full backup completed
    [2019-04-18 16:01:54,357] [backup : 130] [INFO] Local and Remote metadata are synchronized, no sync needed.
    Last full backup date: none
    --------------[ Backup Statistics ]--------------
    StartTime 1555603313.31 (Thu Apr 18 16:01:53 2019)
    EndTime 1555603313.32 (Thu Apr 18 16:01:53 2019)
    ElapsedTime 0.01 (0.01 seconds)
    SourceFiles 3
    SourceFileSize 20495 (20.0 KB)
    NewFiles 3
    NewFileSize 20495 (20.0 KB)
    DeletedFiles 0
    ChangedFiles 0
    ChangedFileSize 0 (0 bytes)
    ChangedDeltaSize 0 (0 bytes)
    DeltaEntries 3
    RawDeltaSize 15 (15 bytes)
    TotalDestinationSizeChange 183 (183 bytes)
    Errors 0
    -------------------------------------------------
    [2019-04-18 16:01:54,357] [backup : 162] [INFO] Scheduling backup as per configurations, please don't stop this program or run this in background !!!
    [2019-04-18 16:01:54,358] [backup : 166] [INFO] Schedule info is: ['daily']
    [2019-04-18 16:01:54,358] [backup : 172] [INFO] Scheduled for daily!!!
    ```

7. データが正常にバックアップまたはリストアされたことを確認します。

   • バックアップ:

     1. IBM Cloud Object Storage のリソース・リストで IBM Cloud サービス・インスタンスを見つけます。
     2. ナビゲーションから「 バケット 」を選択し、バックアップ設定で使用したバケットをクリックします。 バックアップが、バケット内のオブジェクトとして表示されます。
     3. 圧縮ファイルを確認します。 *.gz ファイルをダウンロードし、ファイルを解凍して、バックアップ・データを検証できます。

   • リストア:

     1. リストアされたデータが含まれている PVC をマウントするポッドの deployment.yaml ファイルを作成します。 以下の例では、PVC を nginx マウント・ディレクトリーにマウントする /test ポッドをデプロイします。

          apiVersion: apps/v1
          kind: Deployment
          metadata:
            name: restore
            labels:
            app: nginx
          spec:
            selector:
              matchLabels:
                app: nginx
            template:
              metadata:
                labels:
                  app: nginx
              spec:
                containers:
                  - image: nginx
                    name: nginx
                    volumeMounts:
                    - name: my-volume # Example: my_volume
                      mountPath: /test # Example: /test
                volumes:
                - name: my-volume # Example: my_volume
                  persistentVolumeClaim:
                    claimName: my-actual-pvc-name # Example: my_pvc
        

        spec.containers.image

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

        spec.containers.name

        クラスターにデプロイするコンテナーの名前。

        spec.containers.volumeMounts.mountPath

        コンテナー内でボリュームがマウントされるディレクトリーの絶対パス。 マウント・パスに書き込まれるデータは、物理ブロック・ストレージ・インスタンスのルート・ディレクトリーに保管されます。 異なるアプリ間でボリュームを共有するには、各アプリごとに ボリュームのサブパスを指定することができます。

        spec.containers.volumeMounts.name

        ポッドにマウントするボリュームの名前。

        volumes.name

        ポッドにマウントするボリュームの名前。 通常、この名前は volumeMounts/name と同じです。

        volumes.persistentVolumeClaim.claimName

        使用するPVを結合するPVCの名前。

     2. デプロイメントを作成します。

        oc apply -f deployment.yaml
        

     3. ポッドの状況が「Running」であることを確認します。

        ibm-storage-restore ポッドの状況が「Completed」や「CrashLoopBackOff」に達しない場合、データのリストアに失敗した可能性があります。 oc logs ibm-storage-restore を実行して、失敗の根本原因を見つけてください。

        oc get pods | grep restore
        

        出力例

        restore-7dfc6f4c78-wkcqp                  1/1     Running             0          3m54s
        

     4. ポッドにログインします。

        oc exec <pod_name> -it bash
        

     5. デプロイメント YAML で指定したマウント・ディレクトリーにナビゲートします。

        cd <mount_directory>
        

     6. マウント・ディレクトリー内のファイルをリストして、すべてのデータがマウント・ディレクトリーにリストアされたことを確認します。

        ls
        

     7. クラスターから Helm チャートのインストールを削除します。 この手順は、ブロック・ストレージの PVC にデータをリストアした場合に必要です。 ブロック・ストレージは、RWO アクセス・モードでマウントされます。 このアクセスでは、一度に 1 つのポッドしかブロック・ストレージにマウントできません。 ibm-storage-restore ポッドが既に PVC をマウントしているので、このポッドを削除して PVC を解放して、PVC をクラスター内の別のポッドにマウントできるようにする必要があります。

        helm uninstall <release_name> -n <namespace>
        

     8. バックアップが正常にリストアされました。 これで、PV をバインドする PVC をクラスター内の他の任意のポッドにマウントして、リストアされたファイルにアクセスすることができます。 バックアップされていたコンテナー・データに非 root ユーザーが含まれていた場合は、新規コンテナーに非 root の権限を追加する必要があります。 詳しくは、非 root ユーザーのボリューム・アクセス権限の追加を参照してください。

IBM Cloud Monitoring アラートがトリガーされた場合の永続ストレージのトラブルシューティング

アラートがトリガーされたら、IBM Cloud Monitoring でアラートの詳細を確認し、永続ストレージ、アプリ、ワーカー・ノード、およびクラスターのトラブルシューティング・ガイドを確認してアラートの根本原因を見つけます。 セットアップしたアラートは、ストレージ・ボリュームの問題に関連しているのではなく、アプリ、ワーカー・ノード、またはクラスター内で発生した問題に関連している可能性もあります。

• 永続ストレージ・ボリュームのトラブルシューティングを行います。
• ワーカー・ノードのトラブルシューティングを行います。
• アプリのトラブルシューティングを行います。
• クラスターのトラブルシューティングを行います。
• サポートケースを開いて ください。