ansible-console
用于执行 Ansible 任务的 REPL 控制台。
概要
usage: ansible-console [-h] [--version] [-v] [-b]
[--become-method BECOME_METHOD]
[--become-user BECOME_USER]
[-K | --become-password-file BECOME_PASSWORD_FILE]
[-i INVENTORY] [--list-hosts] [-l SUBSET]
[--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]
[-k | --connection-password-file CONNECTION_PASSWORD_FILE]
[-C] [-D] [--vault-id VAULT_IDS]
[-J | --vault-password-file VAULT_PASSWORD_FILES]
[-f FORKS] [-M MODULE_PATH] [--playbook-dir BASEDIR]
[-e EXTRA_VARS] [--task-timeout TASK_TIMEOUT] [--step]
[pattern]
描述
一个 REPL，允许对从带有内置制表符完成的漂亮 shell（基于 dominis’ 的 ansible-shell）中选择的清单运行临时任务。
它支持多个命令，您可以在运行时修改其配置。
cd [pattern]: 更改主机/组（您可以使用主机模式，例如：app*.dc*:!app01*）list: 列出当前路径中可用的主机list groups: 列出当前路径中包含的组become: 切换 become 标志!: 强制使用 shell 模块而不是 ansible 模块（!yum update -y）verbosity [num]: 设置详细程度级别forks [num]: 设置分叉数become_user [user]: 设置 become_userremote_user [user]: 设置 remote_userbecome_method [method]: 设置特权升级方法check [bool]: 切换检查模式diff [bool]: 切换 diff 模式timeout [integer]: 设置任务的超时时间（以秒为单位）（0 表示禁用）help [command/module]: 显示命令或模块的文档exit: 退出ansible-console
常用选项
- --become-method <BECOME_METHOD>
要使用的特权升级方法（默认值为 sudo），使用 ansible-doc -t become -l 列出有效选项。
- --become-password-file <BECOME_PASSWORD_FILE>, --become-pass-file <BECOME_PASSWORD_FILE>
Become 密码文件
- --become-user <BECOME_USER>
以该用户身份运行操作（默认值为 root）
- --connection-password-file <CONNECTION_PASSWORD_FILE>, --conn-pass-file <CONNECTION_PASSWORD_FILE>
连接密码文件
- --list-hosts
输出匹配主机的列表；不执行任何其他操作
- --playbook-dir <BASEDIR>
由于此工具不使用剧本，因此将其用作剧本目录的替代品。这将设置许多功能的相对路径，包括角色/组变量/等。
- --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
一次一步：在运行之前确认每个任务
- --task-timeout <TASK_TIMEOUT>
设置任务超时时间限制（以秒为单位），必须是正整数。
- --vault-id
要使用的拱顶标识。此参数可以指定多次。
- --vault-password-file, --vault-pass-file
拱顶密码文件
- --version
显示程序的版本号、配置文件位置、配置的模块搜索路径、模块位置、可执行文件位置并退出
- -C, --check
不进行任何更改；而是尝试预测可能发生的某些更改
- -D, --diff
更改（小）文件和模板时，显示这些文件的差异；与 –check 结合使用效果很好
- -J, --ask-vault-password, --ask-vault-pass
询问拱顶密码
- -K, --ask-become-pass
询问特权升级密码
- -M, --module-path
将冒号分隔的路径（s）附加到模块库的前面（默认值为 {{ ANSIBLE_HOME ~ “/plugins/modules:/usr/share/ansible/plugins/modules” }}）。此参数可以指定多次。
- -T <TIMEOUT>, --timeout <TIMEOUT>
覆盖连接超时时间（以秒为单位）（默认值取决于连接类型）。
- -b, --become
以特权用户身份运行操作（不意味着提示输入密码）。
- -c <CONNECTION>, --connection <CONNECTION>
要使用的连接类型（默认值=ssh）。
- -e, --extra-vars
设置额外的变量，以键值对或 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
导致 Ansible 打印更多调试消息。添加多个 -v 会增加详细程度，内置插件目前最多支持 -vvvvvv。一个合理的起始级别是 -vvv，连接调试可能需要 -vvvv。此参数可以多次指定。
参数
- host-pattern
库存中的组名称，一个类似 shell 的 glob 模式，用于选择库存中的主机，或两者以逗号分隔的组合。
环境变量
可以指定以下环境变量。
ANSIBLE_INVENTORY – 覆盖默认的 Ansible 库存文件。
ANSIBLE_LIBRARY – 覆盖默认的 Ansible 模块库路径。
ANSIBLE_CONFIG – 覆盖默认的 Ansible 配置文件。
在 ansible.cfg 中，许多其他选项也支持使用环境变量。
文件
/etc/ansible/hosts – 默认的库存文件。
/etc/ansible/ansible.cfg – 配置文件，如果存在则使用。
~/.ansible.cfg – 用户配置文件，如果存在，则覆盖默认配置。
许可证
Ansible 在 GPLv3+ 许可证的条款下发布。
另请参阅
ansible(1), ansible-config(1), ansible-doc(1), ansible-galaxy(1), ansible-inventory(1), ansible-playbook(1), ansible-pull(1), ansible-vault(1)