ansible
定义并针对一组主机运行单个任务“剧本”。
概要
usage: ansible [-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] [-P POLL_INTERVAL]
[-B SECONDS] [-o] [-t TREE] [--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] [-e EXTRA_VARS] [--vault-id VAULT_IDS]
[-J | --vault-password-file VAULT_PASSWORD_FILES] [-f FORKS]
[-M MODULE_PATH] [--playbook-dir BASEDIR]
[--task-timeout TASK_TIMEOUT] [-a MODULE_ARGS] [-m MODULE_NAME]
pattern
描述
是一个用于执行“远程操作”的极其简单的工具/框架/API。此命令允许您定义并针对一组主机运行单个任务“剧本”。
常用选项
- --become-method <BECOME_METHOD>
要使用的权限提升方法（默认为 sudo），使用 ansible-doc -t become -l 列出有效选项。
- --become-password-file <BECOME_PASSWORD_FILE>, --become-pass-file <BECOME_PASSWORD_FILE>
提升权限密码文件
- --become-user <BECOME_USER>
以该用户身份运行操作（默认为 root）
- --connection-password-file <CONNECTION_PASSWORD_FILE>, --conn-pass-file <CONNECTION_PASSWORD_FILE>
连接密码文件
- --list-hosts
输出匹配的主机列表；不执行任何其他操作
- --playbook-dir <BASEDIR>
由于此工具不使用 playbook，因此将其用作替代 playbook 目录。这将为许多功能设置相对路径，包括角色/组变量/等。
- --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）
- --task-timeout <TASK_TIMEOUT>
以秒为单位设置任务超时限制，必须为正整数。
- --vault-id
要使用的保管库标识。此参数可以指定多次。
- --vault-password-file, --vault-pass-file
保管库密码文件
- --version
显示程序的版本号、配置文件位置、已配置的模块搜索路径、模块位置、可执行文件位置并退出
- -B <SECONDS>, --background <SECONDS>
异步运行，X 秒后失败（默认为 N/A）
- -C, --check
不进行任何更改；而是尝试预测可能发生的某些更改
- -D, --diff
更改（小）文件和模板时，显示这些文件的差异；与 –check 配合使用效果很好
- -J, --ask-vault-password, --ask-vault-pass
提示输入保管库密码
- -K, --ask-become-pass
提示输入提升权限密码
- -M, --module-path
将以冒号分隔的路径预置到模块库（默认为 {{ ANSIBLE_HOME ~ “/plugins/modules:/usr/share/ansible/plugins/modules” }}）。此参数可以指定多次。
- -P <POLL_INTERVAL>, --poll <POLL_INTERVAL>
如果使用 -B，则设置轮询间隔（默认为 15）
- -T <TIMEOUT>, --timeout <TIMEOUT>
覆盖以秒为单位的连接超时（默认取决于连接）
- -a <MODULE_ARGS>, --args <MODULE_ARGS>
以空格分隔的 k=v 格式表示操作的选项：-a ‘opt1=val1 opt2=val2’ 或 JSON 字符串：-a ‘{“opt1”: “val1”, “opt2”: “val2”}’
- -b, --become
使用 become 运行操作（不暗示提示输入密码）
- -c <CONNECTION>, --connection <CONNECTION>
使用的连接类型（默认值为 ssh）
- -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>
将选定的主机进一步限制到其他模式
- -m <MODULE_NAME>, --module-name <MODULE_NAME>
要执行的操作的名称（默认值为 command）
- -o, --one-line
压缩输出
- -t <TREE>, --tree <TREE>
将输出日志记录到此目录
- -u <REMOTE_USER>, --user <REMOTE_USER>
以该用户身份连接（默认值为 None）
- -v, --verbose
导致 Ansible 打印更多调试消息。添加多个 -v 将增加详细程度，内置插件目前最多评估到 -vvvvvv。合理的开始级别是 -vvv，连接调试可能需要 -vvvv。此参数可以多次指定。
环境
可以指定以下环境变量。
ANSIBLE_INVENTORY – 覆盖默认的 Ansible 清单文件
ANSIBLE_LIBRARY – 覆盖默认的 Ansible 模块库路径
ANSIBLE_CONFIG – 覆盖默认的 Ansible 配置文件
在 ansible.cfg 中，还有更多选项可用于大多数选项。
文件
/etc/ansible/hosts – 默认清单文件
/etc/ansible/ansible.cfg – 配置文件，如果存在则使用
~/.ansible.cfg – 用户配置文件，如果存在则覆盖默认配置
许可证
Ansible 在 GPLv3+ 许可证的条款下发布。
另请参阅
ansible-config(1)、ansible-console(1)、ansible-doc(1)、ansible-galaxy(1)、ansible-inventory(1)、ansible-playbook(1)、ansible-pull(1)、ansible-vault(1)