oadp restore precheck

バックアップをリストアする前に、検証を実行して、OADP名前空間が存在すること、リソースが使用可能であること、およびバックアップが存在することを確認します。

このコマンドは、以下の問題を検査します。

  • OADP プロジェクトは存在しません。
  • Velero インスタンスが実行されていないか、そのポッドが正常ではありません。
  • OADP バックアップ・ストレージ・ロケーションのカスタム・リソースが Available 状態ではありません。
  • 指定されたバックアップ名は存在しません。
  • バックアップが正常に完了しなかったか、エラーまたは警告が発生しました。
  • バックアップに関連付けられているプロジェクトが存在しません。

構文

cpd-cli oadp restore precheck \
--backup-names=<backup_name1,
backup_name2, and so on> \
[--cacert=<certificate-bundle-path>] \
[--exclude-checks] \
[--include-checks] \
[--ignore-warnings=true|false] \
[--insecure-skip-tls-verify=true|false]

# Global options
[--add_dir_header=true|false] \
[--alsologtostderr=true|false] \
[--cpd-namespace=<cpd-namespace>] \
[--kubeconfig=<kubeconfig-paths> \
[--log-level=info|debug|warn|error|panic|trace] \
[--log-backtrace-at=<source_code_file>:<line_number>] \
[--log_dir=<log_directory>] \
[--log_file=<log_file_name>] \
[--log_file_max_size=<uint>] \
[--logtostderr=true|false] \
[--namespace=<namespace-name>] \
[--one_output=true|false] \
[--skip_headers=true|false] \
[--skip_log_headers=true|false] \
[--stderrthreshold=<integer>] \
[--v=<integer>] \
[--verbose \
[--vmodule=<pattern1>=<n1>,<pattern2>=<n2>,<pattern3>=<n3>]

引数

表 1: グローバル・オプション引数
引数 説明
<trace-location> スタック・トレースのロケーション
<severity> ログの重大度レベル

オプション

表 1: コマンド・オプション
オプション 説明
--backup-names 検証対象の既存のバックアップのコンマ区切りの名前の有効なリスト。
状況
必須。
構文
--backup-names=<backup_name1, backup_name2, and so on>
デフォルト値
No default.
有効値
リストア前に検証するバックアップ名のコンマ区切りリスト。
--cacert TLS 接続を検証するときに使用する証明書バンドル・パス。
状況
オプションです。
構文
--cacert=<certificate-bundle-path>
デフォルト値
No default.
有効値
有効な証明書バンドル・パス。
--exclude-checks スキップする検査のコンマ区切りリスト。
状況
オプションです。
構文
--exclude-checks=<check1,check2,...>
デフォルト値
No default.
有効値
CheckVeleroInstanceHealth, CheckBSLAvailability, CheckDPAVeleroPlugin, CheckBackupWarningError, CheckBackupNamespaces, CheckIBMCommonServiceValidatingWebhook
--force true の場合、ターゲット名前空間が存在することを許可します。
状況
オプションです。
構文
--force=true|false
デフォルト値
false
有効値
true|false

--help

-h

コマンド・ヘルプを表示します。
状況
オプションです。
構文
--help
デフォルト値
デフォルトなし。
有効値
該当なし。
--ignore-warnings 「true」に設定すると、警告が出されたバックアップにリストアの事前チェック中にエラーのフラグが立てられなくなります。
状況
オプションです。
構文
--ignore-warnings=true|false
デフォルト値

5.3.0 false

5.3.1 true

有効値
true|false
--include-checks 実行する検査のコンマ区切りリスト。 指定されていない検査は実行されません。
状況
オプションです。
構文
--include-checks=<check1,check2,...>
デフォルト値
No default.
有効値
CheckVeleroInstanceHealth, CheckBSLAvailability, CheckDPAVeleroPlugin, CheckBackupWarningError, CheckBackupNamespaces, CheckIBMCommonServiceValidatingWebhook
--insecure-skip-tls-verify 「true」に設定すると、オブジェクト・ストアの TLS 証明書の妥当性検査は行われません (実動では推奨されません)。
状況
オプションです。
構文
--insecure-skip-tls-verify=true|false
デフォルト値
false
有効値
false
オブジェクト・ストアの TLS証明書の妥当性は検査されません。
true
「true」に設定すると、オブジェクト・ストアの TLS 証明書の妥当性検査は行われません (実動では推奨されません)。

グローバル・オプション

このコマンドでは、以下のグローバル・オプションも使用できます。

表 2: コマンド・グローバル・オプション
オプション 説明
--add_dir_header ファイル・ディレクトリーをログ・メッセージのヘッダーに追加します。
状況
オプションです。
構文
--add_dir_header=true|false
デフォルト値
false
有効値
false
ログ・メッセージのヘッダーにファイル・ディレクトリーを追加しません。
true
ファイル・ディレクトリーをログ・メッセージのヘッダーに追加します。
--alsologtostderr 標準エラーおよびファイルにログを記録します。
状況
オプションです。
構文
--alsologtostderr=true|false
デフォルト値
false
有効値
false
ファイルだけでなく標準エラーにもログを記録しません。
true
標準エラーおよびファイルにログを記録します。
注: --logtostderr=trueの場合、このオプションは無効です。
--cpd-namespace ユーティリティーが作動する IBM Software Hub 名前空間。
状況
オプションです。
構文
--cpd-namespace=<cpd-namespace>
デフォルト値
デフォルト値なし。
有効値
有効な IBM® Software Hub 名前空間。
ヒント: このオプションを使用する代わりに、次のコマンドを使用できます。
cpd-cli oadp client config set cpd-namespace=<cpd-namespace>
ただし、このオプションはコマンドよりも優先されます。
--kubeconfig kubeconfig へのパス。 クラスター外の場合にのみ必要です。
状況
オプションです。
構文
--kubeconfig=<kubeconfig-paths>
デフォルト値
No default.
有効値
有効な kubeconfig パス。
--log-level コマンド・ログ・レベル。
状況
オプションです。
構文
--log-level=info|debug|warn|error|panic|trace
デフォルト値
info
有効値
debug
デバッグ・メッセージがログに書き込まれます。
error
エラー・メッセージはログに書き込まれます。
info
通知メッセージがログに書き込まれます。
panic
ログにパニック・メッセージが書き込まれます。
trace
トレース・メッセージがログに書き込まれます。
warn
警告メッセージがログに書き込まれます。
--log-backtrace-at logging ヒット <source_code_file> の行 <line_number> でスタック・トレースを発行します。 デフォルトは、行 0 の任意のファイルです。
状況
オプションです。
構文
--log-backtrace-at=<source_code_file>:<line_number>
デフォルト値

No file and line 0 ( :0)

有効値
<source_code_file>:<line_number> という形式のソース・コード・ファイル内の位置。
--log_dir 空でない場合、このディレクトリーにログ・ファイルを書き込みます。
状況
オプションです。
構文
--log_dir=<log_directory>
デフォルト値
No default.
有効値
有効なディレクトリー。
注: --logtostderr=trueの場合、このオプションは無効です。
--log_file 空でない場合は、このログ・ファイルを使用します。
状況
オプションです。
構文
--log_file=<log_file_name>
デフォルト値
No default.
有効値
有効なディレクトリー。
注: --logtostderr=trueの場合、このオプションは無効です。
--log_file_max_size ログ・ファイルが拡張できる最大サイズ (MB)。 0 を指定すると、最大ファイル・サイズは無制限になります。
状況
オプションです。
構文
--log_file_max_size=<uint>
デフォルト値
1800
有効値
有効な符号なし整数。
注: --logtostderr=trueの場合、このオプションは無効です。
--logtostderr ファイルではなく標準エラーにログを記録します。
状況
オプションです。
構文
--logtostderr=true|false
デフォルト値
true
有効値
true
ファイルではなく標準エラーにログを記録します。
false
ファイルに記録します。
--namespace

-n

OADP がインストールされている名前空間。
状況
オプションです。
構文
--namespace=<oadp-namespace>
デフォルト値
デフォルト値なし。
有効値
有効な名前空間名。
ヒント: このオプションを使用する代わりに、次のコマンドを使用できます。
cpd-cli oadp client config set namespace=<OADP-operator-namespace>
ただし、このオプションはコマンドよりも優先されます。
--one_output ログをネイティブの重大度レベルにのみ書き込むかどうかを指定します。
状況
オプションです。
構文
--one_output=true|false
デフォルト値
false
有効値
false
ログをそれぞれの固有の重大度レベルに書き込み、それより低い重大度レベルにも書き込みます。
true
ログをネイティブの重大度レベルにのみ書き込みます。
注: --logtostderr=trueの場合、このオプションは無効です。
--skip_headers ログ・メッセージのヘッダー接頭部を回避するかどうかを指定します。
状況
オプションです。
構文
--skip_headers
デフォルト値
false
有効値
false
ログ・メッセージ内のヘッダー接頭部を回避しません。
true
ログ・メッセージにヘッダー接頭部を使用しないでください。
--skip_log_headers ログ・ファイルを開くときにヘッダー接頭部を回避するかどうかを指定します。
状況
オプションです。
構文
--skip_log_headers
デフォルト値
false
有効値
false
ログ・ファイルを開くときにヘッダーを回避しません。
true
ログ・ファイルを開くときにヘッダーを避けます。
注: --logtostderr=trueの場合、このオプションは無効です。
--stderrthreshold 指定した重大度しきい値以上のログは、stderr に出力されます。 しきい値は、ファイルおよび stderr への書き込みを有効にするときに使用されます。
状況
オプションです。
構文
--stderrthreshold=<integer>
デフォルト値
2
有効値
任意の正整数。
注: --logtostderr=true または の場合、このオプションは無効です。--alsologtostderr=false
--v

-v

ログ・レベルの詳細度の番号。
状況
オプションです。
構文
--v=<integer>
デフォルト値
No default.
有効値
任意の正整数。
--verbose ログには、より詳細なメッセージが含まれます。
状況
オプションです。
構文
--verbose
デフォルト値
デフォルトなし。
有効値
該当なし。
--vmodule ファイル・フィルター・ロギングの pattern=N 設定のコンマ区切りリスト。
状況
オプションです。
構文
--vmodule=<pattern1>=<n1>,<pattern2>=<n2>,<pattern3>=<n3>
デフォルト値
No default.
有効値

<pattern>=<n> という形式のパターンの有効なコンマ区切りリスト。

注: 以下の例では、推奨されるインストール環境変数を使用します。

スクリプトを使用して、ご使用の環境に合った適切な値で環境変数を作成することを強くお勧めします。 詳しくは、インストール環境変数の設定を参照してください。

リストアの事前チェックを実行します。CheckOadpOperatorCSV のみを検査します。
cpd-cli oadp restore precheck \
--backup-names=zen-backup-operators,zen-backup \
--include-checks=CheckOadpOperatorCSV \
--verbose
CheckOadpOperatorCSVを除くリストアの事前チェックを実行します。
cpd-cli oadp restore precheck \
--backup-names=zen-backup-operators,zen-backup \
--exclude-checks=CheckOadpOperatorCSV \
--verbose