5.26.2.4. Velero CLI ツールを使用した Velero リソースのデバッグ

手順

• oc exec コマンドを使用して、Velero CLI コマンドを実行します。

  $ oc -n openshift-adp exec deployment/velero -c velero -- ./velero \
    <backup_restore_cr> <command> <cr_name>

  oc exec コマンドの例

  $ oc -n openshift-adp exec deployment/velero -c velero -- ./velero \
    backup describe 0e44ae00-5dc3-11eb-9ca8-df7e5254778b-2d8ql

• 次の velero --help オプションを使用して、すべての Velero CLI コマンドをリスト表示します。

  $ oc -n openshift-adp exec deployment/velero -c velero -- ./velero \
    --help

• 次の velero logs コマンドを使用して、Backup または Restore CR のログを取得します。

  $ oc -n openshift-adp exec deployment/velero -c velero -- ./velero \
    <backup_restore_cr> logs <cr_name>

  velero logs コマンドの例

  $ oc -n openshift-adp exec deployment/velero -c velero -- ./velero \
    restore logs ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf

• 次の velero describe コマンドを使用して、Backup または Restore CR に関連する警告とエラーの概要を取得します。

  $ oc -n openshift-adp exec deployment/velero -c velero -- ./velero \
    <backup_restore_cr> describe <cr_name>

  velero describe コマンドの例

  $ oc -n openshift-adp exec deployment/velero -c velero -- ./velero \
    backup describe 0e44ae00-5dc3-11eb-9ca8-df7e5254778b-2d8ql

  次の種類の復元エラーと警告が、velero describe リクエストの出力に表示されます。

• Velero: Velero 自体の操作に関連するメッセージのリスト (クラウドへの接続、バックアップファイルの読み取りなどに関連するメッセージなど)
• Cluster: クラスタースコープのリソースのバックアップまたは復元に関連するメッセージのリスト

• Namespaces: namespace に保存されているリソースのバックアップまたは復元に関連するメッセージのリスト

  これらのカテゴリーのいずれかで 1 つ以上のエラーが発生すると、Restore 操作のステータスが PartiallyFailed になり、Completed ではなくなります。警告によって完了ステータスが変化することはありません。

  これらの復元エラーは、次の点を考慮してください。

• リソース固有のエラー、つまり Cluster および Namespaces エラーの場合、restore describe --details 出力には、Velero によって復元されたすべてのリソースを含むリソースリストが含まれています。このようなエラーが発生したリソースについて、そのリソースが実際にクラスター内にあるかどうかを確認してください。
• リソース固有のエラー、つまり Cluster および Namespaces エラーの場合、restore describe --details 出力には、Velero によって復元されたすべてのリソースを含むリソースリストが含まれています。このようなエラーが発生したリソースについて、そのリソースが実際にクラスター内にあるかどうかを確認してください。

• describe コマンドの出力に Velero エラーがあっても、リソース固有のエラーがない場合は、ワークロードの復元で実際に問題が発生することなく復元が完了した可能性があります。その場合は、復元後のアプリケーションを十分に検証してください。

  たとえば、出力に PodVolumeRestore またはノードエージェント関連のエラーが含まれている場合は、PodVolumeRestores と DataDownloads のステータスを確認します。これらのいずれも失敗しておらず、まだ実行中でもない場合は、ボリュームデータは完全に復元されている可能性があります。