ansible 命令是用于执行“远程操作”的超简单工具/框架/ API。该命令允许您针对一组主机定义并运行单个任务“剧本”。
命令格式
usage: ansible [-h] [--version] [-v] [-b] [--become-method BECOME_METHOD]
[--become-user BECOME_USER] [-K] [-i INVENTORY] [--list-hosts]
[-l SUBSET] [-P POLL_INTERVAL] [-B SECONDS] [-o] [-t TREE] [-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]
[-e EXTRA_VARS] [--vault-id VAULT_IDS]
[--ask-vault-pass | --vault-password-file VAULT_PASSWORD_FILES]
[-f FORKS] [-M MODULE_PATH] [--playbook-dir BASEDIR]
[-a MODULE_ARGS] [-m MODULE_NAME]
pattern
参数详解
可选参数:
--ask-vault-pass # 加密playbook文件时提示输入密码
--list-hosts # 列出执行匹配到的主机,但并不会执行
--playbook-dir BASEDIR # 由于此工具不使用剧本,因此将其用作 替换剧本目录
--syntax-check # 检查Playbook中的语法书写
--vault-id VAULT_IDS # vault id
--vault-password-file # vault 密码文件
--version # 显示程序的版本号,配置文件位置,配置的模块搜索路径,模块位置,可执行文件位置
-B SECONDS, --background SECONDS # 后台运行超时时间,异步运行,X秒之后失败
-C, --check # 模拟执行,不会真正在机器上执行(查看执行会产生什么变化)
-D, --diff # 当更新的文件数及内容较少时,该选项可显示这些文件不同的地方,该选项结合-C用会有较好的效果
-M MODULE_PATH, --module-path MODULE_PATH # 要执行的模块的路径
-P POLL_INTERVAL, --poll POLL_INTERVAL # 设置轮询间隔,单位秒,需要结合 -B 参数使用,默认为 15 秒。
-a MODULE_ARGS, --args MODULE_ARGS # 指定执行模块使用的参数
-e EXTRA_VARS, --extra-vars EXTRA_VARS # 执行命令时添加额外参数变量
-f FORKS, --forks FORKS # 并行任务数。FORKS被指定为一个整数,默认是5
-h, --help # 命令帮助文档
-i INVENTORY, --inventory INVENTORY, --inventory-file INVENTORY # 指定要读取的Inventory文件
-l SUBSET, --limit SUBSET # 限定执行的主机范围
-m MODULE_NAME, --module-name MODULE_NAME # 指定执行使用的模块,默认使用 command 模块
-o, --one-line # 压缩输出,摘要输出,尝试一切都在一行上输出
-t TREE, --tree TREE # 将日志内容保存在该输出目录,结果保存在每台主机上的一个文件中
-v, --verbose # 执行详细输出 (-vvv for more, -vvvv to enable connection debugging)
权限提升参数:
--become-method BECOME_METHOD # 要使用的权限提升方法(默认=sudo),使用 `ansible-doc -t become -l` 列出有效的选择
--become-user BECOME_USER # 以此用户身份运行操作(默认=root)
-K, --ask-become-pass # 要求提权的密码
-b, --become # 设置为yes激活权限提升。
连接参数:
--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 的通用参数
--ssh-extra-args SSH_EXTRA_ARGS # 指定仅传递给 ssh 的额外参数(例如 -R)
-T TIMEOUT, --timeout TIMEOUT # 连接超时时间,单位:秒,默认 10 秒
-c CONNECTION, --connection CONNECTION # 要使用的连接类型,默认是 smart
-k, --ask-pass # 询问连接密码,也就说,使用密码访问的话,需要加此参数
-u REMOTE_USER, --user REMOTE_USER # 以此用户身份连接,默认为 None
演示
添加需要执行任务的主机清单
[root@lanyulei-1 ~]# vim /etc/ansible/hosts
[lanyulei]
172.16.244.154
172.16.244.130
对主机清单内的所有主机,都执行 ping 操作
[root@lanyulei-1 ~]# ansible all -m ping
172.16.244.154 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
172.16.244.130 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}