ansible-console
Ansible タスクを実行する REPL コンソール
概要
usage: ansible-console [-h] [--version] [-v] [-b]
[--become-method BECOME_METHOD]
[--become-user BECOME_USER] [-K] [-i INVENTORY]
[--list-hosts] [-l SUBSET] [-k]
[--private-key PRIVATE_KEY_FILE] [-u REMOTE_USER]
[-c CONNECTION] [-T TIMEOUT]
[--ssh-common-args SSH_COMMON_ARGS]
[--sftp-extra-args SFTP_EXTRA_ARGS]
[--scp-extra-args SCP_EXTRA_ARGS]
[--ssh-extra-args SSH_EXTRA_ARGS] [-C] [--syntax-check]
[-D] [--vault-id VAULT_IDS]
[--ask-vault-password | --vault-password-file VAULT_PASSWORD_FILES]
[-f FORKS] [-M MODULE_PATH] [--playbook-dir BASEDIR]
[-e EXTRA_VARS] [--task-timeout TASK_TIMEOUT] [--step]
[pattern]
説明
(dominis の ansible-shell に基づく) 組み込みのタブ補完機能を備えた優れたシェルから選択したインベントリーに対してアドホックタスクを実行できるようにする REPL。
これは複数のコマンドをサポートし、起動時にその設定を変更できます。
cd [pattern]: ホスト/グループを変更する (app*.dc*:!app01* などのホストパターンを使用できます)。
list: 現在のパスで利用可能なホストを一覧表示する
list groups: 現在のパスに含まれるグループを一覧表示する
become: become フラグを切り替える
!: Ansible モジュールの代わりにシェルモジュールを強制的に実行する (!yum update -y)
verbosity [num]: 詳細レベルを設定する
forks [num]: フォークの数を設定する
become_user [user]: become_user を設定する
remote_user [user]: remote_user を設定する
become_method [method]: 権限昇格方法を設定する
check [bool]: チェックモードを切り替える
diff [bool]: diff モードを切り替える
timeout [integer]: タスクのタイムアウトを秒単位で設定する (無効にするには 0)。
help [command/module]: コマンドまたはモジュールのドキュメントを表示する
exit: ansible-console を終了する
共通オプション
- --ask-vault-password, --ask-vault-pass
Vault のパスワード入力を尋ねます。
- --become-method <BECOME_METHOD>
使用する特権昇格方法 (デフォルトは sudo)。有効な選択を一覧表示するには ansible-doc -t become -l を使用します。
- --become-user <BECOME_USER>
このユーザーとして操作を実行します (デフォルトは root)。
- --list-hosts
一致するホストの一覧を出力します。他には何も実行しません。
- --playbook-dir <BASEDIR>
このツールは Playbook を使用しないため、代替の Playbook ディレクトリーとして使用します。これにより、roles/ group_vars/ などの多くの機能の相対パスが設定されます。
- --private-key <PRIVATE_KEY_FILE>, --key-file <PRIVATE_KEY_FILE>
このファイルを使用して接続を認証します。
- --scp-extra-args <SCP_EXTRA_ARGS>
scp のみに渡す追加の引数を指定します (例: -l)。
- --sftp-extra-args <SFTP_EXTRA_ARGS>
sftp のみに渡す追加の引数を指定します (例: -f、-l)。
- --ssh-common-args <SSH_COMMON_ARGS>
sftp/scp/ssh に渡す一般的な引数を指定します (例: ProxyCommand)。
- --ssh-extra-args <SSH_EXTRA_ARGS>
ssh のみに渡す追加の引数を指定します (例: -R)。
- --step
one-step-at-a-time: 実行前に各タスクを確認する
- --syntax-check
Playbook で構文チェックを実行しますが、Playbook は実行しません。
- --task-timeout <TASK_TIMEOUT>
タスクのタイムアウト制限を秒単位で設定します。正の整数である必要があります。
- --vault-id
使用する Vault アイデンティティー
- --vault-password-file, --vault-pass-file
Vault パスワードファイル
- --version
プログラムバージョン番号、設定ファイルの場所、設定したモジュール検索パス、モジュールの場所、実行可能な場所、および終了を表示します。
- -C, --check
変更を加えないでください。代わりに、発生する可能性のある変更のいくつかを予測してみてください。
- -D, --diff
(小規模な) ファイルおよびテンプレートの変更時に、これらのファイルの相違点を表示します。--check と適切に連携します。
- -K, --ask-become-pass
権限昇格のパスワードを要求します。
- -M, --module-path
モジュールライブラリーへのコロン区切りパス (デフォルトは ~/.ansible/plugins/modules:/usr/share/ansible/plugins/modules) を先頭に追加します。
- -T <TIMEOUT>, --timeout <TIMEOUT>
接続タイムアウトを秒単位で上書きします (デフォルトは 10)。
- -b, --become
become で操作の実行 (パスワード入力を意味するものではありません)
- -c <CONNECTION>, --connection <CONNECTION>
使用する接続タイプ (デフォルトは smart)
- -e, --extra-vars
ファイル名の前に @ を付ける場合は、追加の変数を key=value または YAML/JSON に設定します。
- -f <FORKS>, --forks <FORKS>
使用する並列プロセス数を指定します (デフォルトは 5)。
- -h, --help
ヘルプメッセージを表示して終了します。
- -i, --inventory, --inventory-file
インベントリーホストパスまたはコンマ区切りホスト一覧を指定します。--inventory-file は非推奨になりました。
- -k, --ask-pass
接続のパスワードを要求します。
- -l <SUBSET>, --limit <SUBSET>
選択したホストを追加パターンにさらに制限します。
- -u <REMOTE_USER>, --user <REMOTE_USER>
このユーザーとして接続 します (デフォルトは None)。
- -v, --verbose
詳細モード (-vvv の場合はより詳細になる。-vvvv の場合は接続のデバッグを有効にする)
環境
以下の環境変数を指定できます。
ANSIBLE_CONFIG -- デフォルトの Ansible 設定ファイルを上書きします
ansible.cfg のほとんどのオプションで、さらに多くのものが利用できます。