Ansible速查手册
Ansible使用方法快速参考备忘单
入门
安装
| 安装命令 | 环境 |
|---|---|
brew install ansible |
macos |
yum install -y ansible |
centos |
pip install ansible |
python |
配置位置
| 文件路径 | 说明 |
|---|---|
/etc/ansible/ansible.cfg |
系统范围的配置 |
~/ansible.cfg |
用户特定的配置 |
$pwd/ansible.cfg |
当前目录下的配置 |
配置文件优先级
- 如果没有任何其他配置文件，默认使用
/etc/ansible/ansible.cfg -
~/.ansible.cfg家目录下的.ansible.cfg - 当前目录下的
ansible.cfg，即在同一目录下ansible.cfg优先级高于~/.ansible.cfg - 环境变量
exoport ANSIBLE_CONFIG=/$DIR/ansible.cfg
查看正在使用的 ansible 配置文件：
ansible --version | grep "config file"
Inventory文件(hosts列表)
静态Inventory
/etc/ansible/hosts
mail.example.com
[webservers]
foo.example.com
bar.example.com
Inventory 主机组使用多个IP和域名
[web]
172.18.12.5[1:4]
[webservers]
www[01:50].example.com
Inventory 主机组使用子主机组
[usa:children]
southeast
northeast
southwest
northwest
给多台主机设置变量
group variables
如果组中的所有主机共享一个变量值，则可以一次将该变量应用于整个组
[atlanta]
host1
host2
[atlanta:vars]
ntp_server=ntp.atlanta.example.com
proxy=proxy.atlanta.example.com
命令行(ad-hoc)
ansible
检查Inventory是否生效
$ ansible all --list-hosts
ping所有目标
$ ansible all -m ping
ping本地(不使用SSH连接)
$ ansible all -i localhost, -e '{"ansible_connection": "local"}' -m ping
本地执行命令
$ ansible all -i localhost, -e '{"ansible_connection": "local"}' -a 'hostname'
获取本地主机的信息
$ ansible all -i localhost, -e '{"ansible_connection": "local"}' -m setup
获取远程到本地
$ ansible target -m fetch -a "src=/tmp/seq dest=/tmp/seq"
拷贝本地到远程
$ ansible target -m copy -a "src=/tmp/seq dest=/tmp/seq"
Ansible 命令帮助
$ ansible
$ ansible <host-pattern> [options]
| :- | - |
|---|---|
-a MODULE_ARGS, --args=MODULE_ARGS
|
模块参数 |
--ask-vault-pass |
询问保险库密码 |
-B SECONDS, --background=SECONDS
|
异步运行，X 秒后失败 (默认=N/A) |
-C, --check
|
不要做任何改变；相反，尝试预测可能发生的一些变化 |
-D, --diff
|
更改(小)文件和模板时，显示这些文件中的差异； 与 --check 配合使用效果很好 |
-e EXTRA_VARS, --extra-vars=EXTRA_VARS
|
将附加变量设置为 key=value 或 YAML/JSON |
-f FORKS, --forks=FORKS
|
指定要使用的并行进程数 (default=5) |
-h, --help
|
显示此帮助信息并退出 |
-i INVENTORY, --inventory-file=INVENTORY
|
指定清单主机路径(默认=/etc/ansible/hosts)或逗号分隔的主机列表 |
-l SUBSET, --limit=SUBSET
|
进一步将选定主机限制为其他模式 |
--list-hosts |
输出匹配主机列表；不执行任何其他操作 |
-m MODULE_NAME, --module-name=MODULE_NAME
|
要执行的模块名称 (default=command) |
-M MODULE_PATH, --module-path=MODULE_PATH
|
指定模块库的路径 (default=None) |
--new-vault-password-file=NEW_VAULT_PASSWORD_FILE |
用于重新生成密钥的新保管库密码文件 |
-o, --one-line
|
压缩输出 |
--output=OUTPUT_FILE |
用于加密或解密的输出文件名； 使用 - 用于标准输出 |
-P POLL_INTERVAL, --poll=POLL_INTERVAL
|
如果使用 -B 则设置轮询间隔(default=15) |
--syntax-check |
对 playbook 执行语法检查，但不要执行它 |
-t TREE, --tree=TREE
|
将输出记录到此目录 |
--vault-password-file=VAULT_PASSWORD_FILE |
保险库密码文件 |
-v, --verbose
|
详细模式(-vvv 更多，-vvvv 启用连接调试) |
--version |
显示程序的版本号并退出 |
控制谁以及如何连接到主机，连接选项：
| :- | - |
|---|---|
-k, --ask-pass
|
询问连接密码 |
--private-key=PRIVATE_KEY_FILE, --key-file=PRIVATE_KEY_FILE
|
使用此文件来验证连接 |
-u REMOTE_USER, --user=REMOTE_USER
|
以此用户身份连接(default=None) |
-c CONNECTION, --connection=CONNECTION
|
要使用的连接类型 (default=smart) |
-T TIMEOUT, --timeout=TIMEOUT
|
以秒为单位覆盖连接超时 (default=10) |
--ssh-common-args=SSH_COMMON_ARGS |
指定要传递给 sftp/scp/ssh 的常用参数 (e.g. ProxyCommand) |
--sftp-extra-args=SFTP_EXTRA_ARGS |
指定仅传递给 sftp 的额外参数 (e.g. -f, -l) |
--scp-extra-args=SCP_EXTRA_ARGS |
指定仅传递给 scp 的额外参数 (e.g. -l) |
--ssh-extra-args=SSH_EXTRA_ARGS |
指定仅传递给 ssh 的额外参数 (e.g. -R) |
控制您成为目标主机上的用户的方式和用户，特权升级选项：
| :- | - |
|---|---|
-s, --sudo
|
使用 sudo (nopasswd) 运行操作(已弃用，使用 become) |
-U SUDO_USER, --sudo-user=SUDO_USER
|
所需的 sudo 用户(默认=root)(已弃用，使用 become) |
-S, --su
|
使用 su 运行操作(已弃用，使用 become) |
-R SU_USER, --su-user=SU_USER
|
以该用户身份使用 su 运行操作(默认 = root)(已弃用，使用 become) |
-b, --become
|
使用 become 运行操作(不暗示密码提示) |
--become-method=BECOME_METHOD |
要使用的权限提升方法(默认=sudo)，有效选择：[ sudo |
--become-user=BECOME_USER |
以该用户身份运行操作(默认=root) |
--ask-sudo-pass |
询问 sudo 密码(已弃用，使用 become) |
--ask-su-pass |
询问 su 密码(已弃用，使用 become) |
-K, --ask-become-pass
|
要求提权密码 |
Ansible Galaxy 工具
$ ansible-galaxy [delete|import|info|init|install|list|login|remove|search|setup] [--help] [options] ...
| :- | - |
|---|---|
-h, --help
|
显示此帮助信息并退出 |
-v, --verbose
|
详细模式(-vvv 更多，-vvvv 启用连接调试) |
--version |
显示程序的版本号并退出 |
$ ansible-galaxy search --author <AUTHOR>
$ ansible-galaxy search --platforms <PLATFORM>
$ ansible-galaxy search --galaxy-tags <TAG>
$ ansible-galaxy info <ROLE>
$ ansible-galaxy install <ROLE> -p <ROLE_DIRECTORY>
$ ansible-galaxy install -r <ROLE1> <ROLE2> <ROLE3> ...
$ ansible-galaxy list
$ ansible-galaxy remove <ROLE>
$ ansible-galaxy init <ROLE>
$ ansible-galaxy init --offline <ROLE>
ansible-doc
在本地访问文档
$ ansible-doc
$ ansible-doc [options] [module...]
| :- | - |
|---|---|
-h, --help
|
显示此帮助信息并退出 |
-l, --list
|
列出可用模块 |
-M MODULE_PATH, --module-path=MODULE_PATH
|
指定模块库的路径 (default=None) |
-s, --snippet
|
显示指定模块的剧本片段 |
-v, --verbose
|
详细模式(-vvv 更多，-vvvv 启用连接调试) |
--version |
显示程序的版本号并退出 |
ansible-vault
$ ansible-vault
$ ansible-vault [create|decrypt|edit|encrypt|rekey|view] [--help] [options] vaultfile.yml
| :- | - |
|---|---|
--ask-vault-pass |
询问保险库密码 |
-h, --help
|
显示此帮助信息并退出 |
--new-vault-password-file=NEW_VAULT_PASSWORD_FILE |
用于重新生成密钥的新保管库密码文件 |
--output=OUTPUT_FILE |
用于加密或解密的输出文件名； 使用 - 用于标准输出 |
--vault-password-file=VAULT_PASSWORD_FILE |
保险库密码文件 |
-v, --verbose
|
详细模式(-vvv 更多，-vvvv 启用连接调试) |
--version |
显示程序的版本号并退出 |
ansible-playbook
$ ansible-playbook
$ ansible-playbook playbook.yml
| :- | - |
|---|---|
--ask-vault-pass |
询问保险库密码 |
-C, --check
|
不要做任何改变；相反，尝试预测可能发生的一些变化 |
-D, --diff
|
更改（小）文件和模板时，显示这些文件中的差异；与 --check 配合使用效果很好 |
-e EXTRA_VARS, --extra-vars=EXTRA_VARS
|
将附加变量设置为 key=value 或 YAML/JSON |
--flush-cache |
清除事实缓存 |
--force-handlers |
即使任务失败也运行处理程序 |
-f FORKS, --forks=FORKS
|
指定要使用的并行进程数（默认值=5） |
-h, --help
|
显示此帮助信息并退出 |
-i INVENTORY, --inventory-file=INVENTORY
|
指定清单主机路径（默认=/etc/ansible/hosts）或逗号分隔的主机列表 |
-l SUBSET, --limit=SUBSET
|
进一步将选定主机限制为其他模式 |
--list-hosts |
输出匹配主机列表；不执行任何其他操作 |
--list-tags |
列出所有可用的标签 |
--list-tasks |
列出所有将要执行的任务 |
-M MODULE_PATH, --module-path=MODULE_PATH
|
指定模块库的路径（默认=无） |
--new-vault-password-file=NEW_VAULT_PASSWORD_FILE |
用于重新生成密钥的新保管库密码文件 |
--output=OUTPUT_FILE |
用于加密或解密的输出文件名；使用 - 用于标准输出 |
--skip-tags=SKIP_TAGS |
只运行标签与这些值不匹配的播放和任务 |
--start-at-task=START_AT_TASK |
在匹配此名称的任务处启动剧本 |
--step |
一步一步：在运行前确认每个任务 |
--syntax-check |
对 playbook 执行语法检查，但不要执行它 |
-t TAGS, --tags=TAGS
|
只运行带有这些值标记的播放和任务 |
--vault-password-file=VAULT_PASSWORD_FILE |
保险库密码文件 |
-v, --verbose
|
详细模式（-vvv 更多，-vvvv 启用连接调试） |
--version |
显示程序的版本号并退出 |
连接选项：
| :- | - |
|---|---|
-k, --ask-pass
|
询问连接密码 |
--private-key=PRIVATE_KEY_FILE, --key-file=PRIVATE_KEY_FILE
|
使用此文件来验证连接 |
-u REMOTE_USER, --user=REMOTE_USER
|
以此用户身份连接(默认=None) |
-c CONNECTION, --connection=CONNECTION
|
要使用的连接类型(默认=smart) |
-T TIMEOUT, --timeout=TIMEOUT
|
以秒为单位覆盖连接超时(默认值 = 10) |
--ssh-common-args=SSH_COMMON_ARGS |
指定要传递给 sftp/scp/ssh 的常用参数(例如 ProxyCommand) |
--sftp-extra-args=SFTP_EXTRA_ARGS |
指定仅传递给 sftp 的额外参数(例如 -f、-l) |
--scp-extra-args=SCP_EXTRA_ARGS |
指定仅传递给 scp 的额外参数(例如 -l) |
--ssh-extra-args=SSH_EXTRA_ARGS |
指定仅传递给 ssh 的额外参数(例如 -R) |
特权升级选项：
| :- | - |
|---|---|
-s, --sudo
|
使用 sudo (nopasswd) 运行操作(已弃用，使用 become) |
-U SUDO_USER, --sudo-user=SUDO_USER
|
所需的 sudo 用户(默认=root)(已弃用，使用become) |
-S, --su
|
使用 su 运行操作(已弃用，使用 become) |
-R SU_USER, --su-user=SU_USER
|
以该用户身份使用 su 运行操作(默认 = root)(已弃用，使用become) |
-b, --become
|
使用 become 运行操作(不暗示密码提示) |
--become-method=BECOME_METHOD |
要使用的权限提升方法(默认=sudo)，有效选择：[ sudo | su | pbrun | pfexec | runas | doas | dzdo ] |
--become-user=BECOME_USER |
以该用户身份运行操作(默认=root) |
--ask-sudo-pass |
询问 sudo 密码(已弃用，使用 become) |
--ask-su-pass |
询问 su 密码(已弃用，使用 become) |
-K, --ask-become-pass
|
要求提权密码 |
ansible-pull
$ ansible-pull
$ ansible-pull -U <repository> [options]
| :- | - |
|---|---|
--accept-host-key |
如果尚未添加，则添加 repo url 的主机密钥 |
--ask-vault-pass |
询问保险库密码 |
-C CHECKOUT, --checkout=CHECKOUT
|
分支/标签/提交结帐。默认为存储库模块的行为。 |
-d DEST, --directory=DEST
|
签出存储库的目录 |
-e EXTRA_VARS, --extra-vars=EXTRA_VARS
|
将附加变量设置为 key=value 或 YAML/JSON |
-f, --force
|
即使无法更新存储库也运行 playbook |
--full |
做一个完整的克隆，而不是一个浅的 |
-h, --help
|
显示此帮助信息并退出 |
-i INVENTORY, --inventory-file=INVENTORY
|
指定清单主机路径(默认=/etc/ansible/hosts)或逗号分隔的主机列表 |
-l SUBSET, --limit=SUBSET
|
进一步将选定主机限制为其他模式 |
--list-hosts |
输出匹配主机列表；不执行任何其他操作 |
-m MODULE_NAME, --module-name=MODULE_NAME
|
存储库模块名称，ansible 将使用它来签出 repo。默认是 git |
-M MODULE_PATH, --module-path=MODULE_PATH
|
指定模块库的路径(默认=无) |
--new-vault-password-file=NEW_VAULT_PASSWORD_FILE |
用于重新生成密钥的新保管库密码文件 |
-o, --only-if-changed
|
仅在存储库已更新时才运行 playbook |
--output=OUTPUT_FILE |
用于加密或解密的输出文件名；使用 - 用于标准输出 |
--purge |
剧本运行后清除结帐 |
--skip-tags=SKIP_TAGS |
只运行标签与这些值不匹配的播放和任务 |
-s SLEEP, --sleep=SLEEP
|
在开始之前休眠随机间隔(在 0 到 n 秒之间)。这是分散 git 请求的有用方法 |
-t TAGS, --tags=TAGS
|
只运行带有这些值标记的播放和任务 |
-U URL, --url=URL
|
剧本存储库的 URL |
--vault-password-file=VAULT_PASSWORD_FILE |
保险库密码文件 |
-v, --verbose
|
详细模式(-vvv 更多，-vvvv 启用连接调试) |
--verify-commit |
验证签出提交的 GPG 签名，如果失败则中止运行 playbook。这就需要对应的VCS模块来支持这样的操作 |
--version |
显示程序的版本号并退出 |
连接选项：
| :- | - |
|---|---|
-k, --ask-pass
|
询问连接密码 |
--private-key=PRIVATE_KEY_FILE, --key-file=PRIVATE_KEY_FILE
|
使用此文件来验证连接 |
-u REMOTE_USER, --user=REMOTE_USER
|
以此用户身份连接(默认=无) |
-c CONNECTION, --connection=CONNECTION
|
要使用的连接类型(默认=智能) |
-T TIMEOUT, --timeout=TIMEOUT
|
以秒为单位覆盖连接超时(默认值 = 10) |
--ssh-common-args=SSH_COMMON_ARGS |
指定要传递给 sftp/scp/ssh 的常用参数(例如 ProxyCommand) |
--sftp-extra-args=SFTP_EXTRA_ARGS |
指定仅传递给 sftp 的额外参数(例如 -f、-l) |
--scp-extra-args=SCP_EXTRA_ARGS |
指定仅传递给 scp 的额外参数(例如 -l) |
--ssh-extra-args=SSH_EXTRA_ARGS |
指定仅传递给 ssh 的额外参数(例如 -R) |
特权升级选项：
| :- | - |
|---|---|
--ask-sudo-pass |
询问 sudo 密码(已弃用，使用become) |
--ask-su-pass |
询问 su 密码(已弃用，使用become) |
-K, --ask-become-pass
|
要求提权密码 |
说明
这是一个快速参考备忘单，提供了使用Ansible的各种方法的入门指南，供开发人员参考。
陕公网安备61019002002295号
