Ansible 小手册系列 三(命令介绍)

Ansible 版本:2.1.2.0

ansible


ansible是指令核心部分,其主要用于执行ad-hoc命令,即单条命令。默认后面需要跟主机和选项部分,默认不指定模块时,使用的是command模块。

Usage: ansible <host-pattern> [options]

选项:

参数 说明
-a MODULE_ARGS, --args=MODULE_ARGS 模块的参数。
--ask-vault-pass vault 密码。
-B SECONDS, --background=SECONDS 异步运行时,多长时间超时。
-C, --check 只是测试一下会改变什么内容,不会真正去执行;相反,试图预测一些可能发生的变化。
-D, --diff 当更改文件和模板时,显示这些文件得差异,比--check效果好。
-e EXTRA_VARS, --extra-vars=EXTRA_VARS 添加附加变量,比如key=value,yaml,json格式。
-f FORKS, --forks=FORKS 指定定要使用的并行进程数,默认为5个。
-h, --help 显示此帮助信息。
-i INVENTORY, --inventory-file=INVENTORY 指定主机清单文件或逗号分隔的主机,默认为/etc/ansible/hosts。
-l SUBSET, --limit=SUBSET 进一步限制所选主机/组模式,只执行-l 后的主机和组。
--list-hosts 输出匹配主机的列表。
-m MODULE_NAME, --module-name=MODULE_NAME 要执行的模块,默认为command。
-M MODULE_PATH, --module-path=MODULE_PATH 要执行的模块的路径。
--new-vault-password-file=NEW_VAULT_PASSWORD_FILE 新vault密钥文件。
-o, --one-line 压缩输出,摘要输出.尝试一切都在一行上输出。
--output=OUTPUT_FILE 加密或解密输出文件名 用于标准输出。
-P POLL_INTERVAL, --poll=POLL_INTERVAL 如果使用-B,则设置轮询间隔。
--syntax-check 对playbook进行语法检查,且不执行playbook。
-t TREE, --tree=TREE 将日志内容保存在该目录中,文件名以执行主机名命名。
--vault-password-file=VAULT_PASSWORD_FILE vault密码文件
-v, --verbose 输出执行的详细信息,使用-vvv获得更多,-vvvv 启用连接调试
--version 显示程序版本号

连接选项:

参数 说明
-k, --ask-pass 要求用户输入请求连接密码
--private-key=PRIVATE_KEY_FILE, --key-file=PRIVATE_KEY_FILE 私钥路径,使用这个文件来验证连接
-u REMOTE_USER, --user=REMOTE_USER 连接用户
-c CONNECTION, --connection=CONNECTION 连接类型,默认smart
-T TIMEOUT, --timeout=TIMEOUT 指定默认超时时间,默认是10S
--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)运行操作 , 不推荐使用
-U SUDO_USER, --sudo-user=SUDO_USER sudo 用户,默认为root, 不推荐使用
-S, --su 使用su运行操作, 不推荐使用
-R SU_USER, --su-user=SU_USER su 用户,默认为root,不推荐使用
-b, --become 运行操作
--become-method=BECOME_METHOD 权限升级方法使用 ,默认为sudo,有效选择:sudo,su,pbrun,pfexec,runas,doas,dzdo
--become-user=BECOME_USER 使用哪个用户运行,默认为root
--ask-sudo-pass sudo密码,不推荐使用
--ask-su-pass su密码,不推荐使用
-K, --ask-become-pass 权限提升密码

示例:

ansible all -m ping
ansible 192.168.77.* -m ping
ansible all -m command -a ifconfig
ansible all -m shell -a "ifconfig eth0 |grep 'inet addr' "
ansible -i "192.168.77.129,192.168.77.130" 192.168.77.129  -m ping
ansible -i hosts  all --list-host
ansible -i hosts -l 192.168.77.130 all -m ping -t /tmp -vvvv
ansible web -l @retry_hosts.txt --list-hosts

ansible-console


交互式命令执行界面

Usage: ansible-console <host-pattern> [options]

选项与ansible一致

ansible-doc


该指令用于查看模块信息,常用参数有两个-l-s

Usage: ansible <host-pattern> [options]

选项

参数 说明
-h, --help 显示此帮助信息
-l, --list 列出可用的模块
-M MODULE_PATH, --module-path=MODULE_PATH 指定到模块库的路径
-s, --snippet 显示playbook制定模块的用法
-v, --verbose 详细模式(-vvv表示更多,-vvvv表示启用连接调试)
--version 显示程序版本号

示例:

ansible-doc -l
ansible-doc yum
ansible-doc yum -s

ansible-galaxy


ansible-galaxy 指令用于方便的从 https://galaxy.ansible.com/ 站点下载第三方扩展模块,我们可以形象的理解其类似于centos下的yum、python下的pip或easy_install

Usage: ansible-galaxy [delete|import|info|init|install|list|login|remove|search|setup] [--help] [options] …

示例:

ansible-galaxy install aeriscloud.docker  # 下载
ansible-galaxy  init abc   # 创建角色模板

ansible-playbook


对于需反复执行的、较为复杂的任务,我们可以通过定义 Playbook 来搞定。Playbook 是 Ansible 真正强大的地方,它允许使用变量、条件、循环、以及模板,也能通过角色 及包含指令来重用既有内容。

Usage: ansible-playbook playbook.yml

相对于ansible,增加了下列选项:

参数 说明
--flush-cache 清除fact缓存
--force-handlers 如果任务失败,也要运行handlers
--list-tags 列出所有可用的标签
--list-tasks 列出将要执行的所有任务
--skip-tags=SKIP_TAGS 跳过运行标记此标签的任务
--start-at-task=START_AT_TASK 在此任务处开始运行
--step 一步一步:在运行之前确认每个任务
-t TAGS, --tags=TAGS 只运行标记此标签的任务

示例:

ansible-playbook -i hosts ssh-addkey.yml    # 指定主机清单文件
ansible-playbook -i hosts ssh-addkey.yml  --list-tags   # 列出tags
ansible-playbook -i hosts ssh-addkey.yml  -T install  # 执行install标签的任务

ansible-pull


pull模式在被配置的机器上运行,速度很快。在这种模式下,你需要提供一个git仓库来供Ansible下载来配置你的机器。

Usage: ansible-pull -U <repository> [options]

ansible-vault


ansible-vault主要应用于配置文件中含有敏感信息,又不希望他能被人看到,vault可以帮你加密/解密这个配置文件。这种playbook文件在执行时,需要加上 –ask-vault-pass参数,同样需要输入密码后才能正常执行。

Usage: ansible-vault [create|decrypt|edit|encrypt|rekey|view] [--help] [options] vaultfile.yml

示例:

ansible-vault create /tmp/123 # 创建加密文件
ansible-vault view  /tmp/123 # 查看加密文件
ansible-vault encrypt  /tmp/abc # 加密文件
ansible-vault decrypt  /tmp/abc # 解密文件

更多文章请看 Ansible 专题文章总览

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,511评论 1 330
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,495评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,595评论 0 225
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,558评论 0 190
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,715评论 3 270
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,672评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,112评论 2 291
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,837评论 0 181
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,417评论 0 228
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,928评论 2 232
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,316评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,773评论 2 234
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,253评论 3 220
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,827评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,440评论 0 180
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,523评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,583评论 2 249

推荐阅读更多精彩内容

  • ansible 系统架构 ansible简介ansible是新出现的自动化运维工具,ansible是一个配置管理和...
    运维阿文阅读 9,491评论 1 52
  • 1. Ansible程序目录功能介绍 rpm -ql ansible 通过如上命令可获取ansible所有文件存放...
    stanleylst阅读 2,584评论 3 16
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,048评论 18 139
  • 简介 ansible是一个简单的it自动化工具,可以实现批量进行系统配置,软件部署和运行命令等功能。基于pytho...
    clickdiff阅读 691评论 0 1
  • 我种的花慢慢的发芽, 我默许的话全给了它。 我给他讲, 你是太阳的孩子, 你来自遥远的南美, 沐浴着珠峰的净水, ...
    田静海阅读 686评论 2 8