1.4. CLI の実行
以下のコマンドを使用して CLI アプリケーションを起動します。
# ovirt-shell
この ovirt-shell アプリケーションは、Red Hat Virtualization 環境のインタラクティブなシェルです。
Red Hat Virtualization Manager に接続するための URL、ユーザー名、認証局ファイル、およびパスワードは、
.ovirtshellrc ファイルで設定できます。ovirt-shell コマンドは、このファイルのパラメーターを使用して Manager に接続するため、ユーザーが毎回オプションを指定する必要はありません。
または、以下の追加オプションを使用して、ユーザーは Red Hat Virtualization Manager に自動的に接続できます。
# ovirt-shell -c -l "https://[server]/ovirt-engine/api" -P [port] -u "[user@domain]" -A "[certificate]"
以下の値を置き換えてください。
- サーバー - Red Hat Virtualization Manager のホスト名または IP アドレス。CLI は、REST API 経由で Red Hat Virtualization Manager に接続します。
- user@domain: Red Hat Virtualization Manager にログインするユーザーのユーザー名およびディレクトリーサービスドメイン。
- 証明書 - 認証局ファイルのパス名。
シェルによりパスワードの入力が求められます。まだ指定されていない場合は、Red Hat Virtualization Manager のユーザー名および URL の入力が求められます。
注記
.ovirtshellrc ファイルにユーザー名、パスワード、URL、および認証局ファイルを設定した場合は、追加のオプションを指定する必要はありません。
注記
この例で使用されている他のオプションは、シェルによってプロンプトが表示されるため、証明書は obligatory のみです。証明書を指定する代わりに、認証なしで接続するために--insecure オプションを使用できますが、中間者(MITM)攻撃者がサーバーのアイデンティティーを偽装できる可能性があるため、この方法は推奨されません。
ovirt-shell のオプション
- -h, --help
- ovirt-shell のヘルプを表示します。
- -d, --debug
- デバッグを有効にします。
- -L URL, --url=URL
- API エントリーポイント URL を指定します。
- -u USERNAME, --username=USERNAME
- このユーザーとして接続します。
- -K KEY_FILE, --key-file=KEY_FILE
- キーファイルを指定します。
- -C CERT_FILE, --cert-file=CERT_FILE
- 証明書ファイルを指定します。
- -A CA_FILE, --ca-file=CA_FILE
- サーバー認証局ファイルを指定します。
- -I, --insecure
- CLI が認定なしで SSL 経由で接続できるようにします。このオプションは、中間者(MITM)攻撃者がサーバーのアイデンティティーを偽装できるため、注意して使用してください。
- -F, --filter
- ユーザーパーミッションに基づいてフィルターリングを有効にします。
- -P PORT, --port=PORT
- port を指定します。
- -T TIMEOUT, --timeout=TIMEOUT
- timeout を指定します。
- -c, --connect
- 自動接続。
- -e, --extended-prompt
- シェルの拡張プロンプトオプションを有効にします。このオプションは、コマンドプロンプトに環境のホスト名を表示します。デフォルトは false です。
- -e "command resource", --execute-command="command resource"
- Manager に接続して、指定したコマンドだけをcommand resource;command resourceの形式で実行し、出力を STDIO に出力します。
- -f FILE, --file=FILE
- stdin の代わりに FILE からコマンドを読み取ります。
- --kerberos
- 有効な Kerberos チケットを使用して、シェルへの接続を認証します。
注記
非対話型シェルを持つユーザーは、--password オプションを使用できるシェル内から Red Hat Virtualization Manager に接続できます。
