Ansible Ad-Hoc命令集
Posted 云技术实践
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Ansible Ad-Hoc命令集相关的知识,希望对你有一定的参考价值。
目录:
3.1 Ad-Hoc使用场景
1、需要使用Ad-Hoc的场景
2、需要使用Ansible-playbook的场景
3.2 Ad-Hoc命令集介绍
3.2.1 Ad-Hoc命令集用法简介
3.2.2 通过Ad-Hoc查看系统设置
3.2.3 通过Ad-Hoc研究Ansible的并发特性
3.2.4 通过Ad-Hoc研究Ansible的模块使用
小编有话要说:
Ansible Ad-Hoc命令集
3.1 Ad-Hoc使用场景
所谓Ad-Hoc简而言之是:“临时命令”,英文中作为形容词有“特别的,临时”的含义。Ad-Hoc只是官方对Ansible命令的一种称谓,大家按各自习惯称谓均可,就笔者而言平时一般称之为“临时操作”或Ansible命令。
Ad-Hoc就其功能上是相对Ansible-playbook而言,Ansible提供两种方式完成任务:
一种是Ad-Hoc命令集,即命令ansible,另外一种就是Ansible-playbook了,即命令ansible-playbook。前者更注重于解决一些简单或者平时工作中临时遇到的任务,相当于Linux系统命令行下的Shell命令,后者更适合于解决复杂或需固化下来的任务,相当于Linux系统的Shell Scripts。通常,深入Ansible是从接触Ansible-playbook后开始,灵活运用Ansible-playbook才能更好地体会到Ansible的强大所在。
具体来讲,什么样的场景下我们需要用到Ad-Hoc,什么样的情况下需要使用Ansible-playbook呢?
1、需要使用Ad-Hoc的场景
情景1:
春节将至(好吧,写这个章节的时候,离过年已经不到半个月了),我们需要关闭所有不必要的服务器,并对所有服务器进行节前健康检查。
情景2:
临时更新Apache &nginx的配置文件,且需同时将其分发至所有需更新该配置的Web服务器。
2、需要使用Ansible-playbook的场景
情景1:
新购置的服务器安装完系统后需做一系列固化的初始化工作,诸如:定制防火墙策略,添加NTP时间同步配置,添加EPEL源等。
情景2:
业务侧每周定期对生产环境发布更新程序代码。
Ansible-playbook其实两者之间关系用急行军(Ad-Hoc)和远征军(Ansible-playbook)来形容可能更容易理解。急行军需轻装上阵,注重灵活机动; 远征军需稳扎稳打,注重长远规划。正如我们上面所讲,Ad-Hoc更注重于解决一些简单或者平时工作中临时遇到的任务,Ansible-playbook更适合于解决复杂或需固化下来的任务。后面的章节中我们会介绍大量企业实战场景,相信大家会有更深刻的体会。
3.2 Ad-Hoc命令集介绍
3.1节我们介绍了Ad-Hoc的使用场景,本小节为大家介绍通过Ad-Hoc 命令集Ansible查看系统设置,通过Ad-Hoc研究Ansible的并发特性,通过Ad-Hoc研究Ansible的模块使用。磨刀不误砍柴工,开始之前做一些简单的初始化化检查,如系统时间正确与否,磁盘容量是否充足等,这些检查工作是很有必要的。
3.2.1 Ad-Hoc命令集用法简介
本节我们介绍Ad-Hoc命令集用法。Ad-Hoc命令集的由/usr/bin/ansible实现,其命令用法如下:
ansible <host-pattern> [options]
可用选项
-v, --verbose
:输出更详细的执行过程信息,-vvv可得到所有执行过程信息。-i PATH, --inventory=PATH
:指定inventory信息,默认/etc/ansible/hosts。-f NUM, --forks=NUM
:并发线程数,默认5个线程。--private-key=PRIVATE_KEY_FILE
:指定密钥文件。-m NAME, --module-name=NAME
:指定执行使用的模块。-M DIRECTORY, --module-path=DIRECTORY
:指定模块存放路径,默认/usr/share/ansible,也可以通过ANSIBLE_LIBRARY设定默认路径。-a 'ARGUMENTS', --args='ARGUMENTS'
:模块参数。-k, --ask-pass SSH
:认证密码。-K, --ask-sudo-pass sudo
:用户的密码(—sudo时使用)。-o, --one-line
:标准输出至一行。-s, --sudo
:相当于Linux系统下的sudo命令。-t DIRECTORY, --tree=DIRECTORY
:输出信息至DIRECTORY目录下,结果文件以远程主机名命名。-T SECONDS, --timeout=SECONDS
:指定连接远程主机的最大超时,单位是:秒。-B NUM, --background=NUM
:后台执行命令,超NUM秒后kill正在执行的任务。-P NUM, --poll=NUM
:定期返回后台任务进度。-u USERNAME, --user=USERNAME
:指定远程主机以USERNAME运行命令。-U SUDO_USERNAME, --sudo-user=SUDO_USERNAM
:E使用sudo,相当于Linux下的sudo命令。-c CONNECTION, --connection=CONNECTION
:指定连接方式,可用选项paramiko (SSH), ssh, local。Local方式常用于crontab 和 kickstarts。-l SUBSET, --limit=SUBSET
:指定运行主机。-l ~REGEX, --limit=~REGEX
:指定运行主机(正则)。--list-hosts
:列出符合条件的主机列表,不执行任何其他命令
下面的示例有助于加深对其理解程度
情景1:
检查proxy组所有主机是否存活
执行命令:
ansible proxy –f 5 –m ping
返回结果如图3-1所示。
图3-1 ansibleping命令返回结果如下
执行结果诠释
192.168.37.159 | success >> {
"changed": false,
"ping": "pong"
}
其中192.168.37.159是指命令执行的主机,Success表示命令执行成功,>> {} 表示详细返回结果如下。”changed”: false表示没有对主机做变更,”ping”: “pong”表示执行了ping命令返回结果为pong。
情景2
返回proxy组所有主机的hostname并打印最详细的执行过程到标准输出
执行命令:
ansible proxy -s -m command -a 'hostname' -vvv
返回结果如下图:
图3-2 ansiblehostname命令返回结果
执行结果诠释:
<192.168.37.159> ESTABLISH CONNECTION FOR USER: root on PORT 22 TO 192.168.37.159 #远程主机192.168.37.159监听ROOT用户的22号端口
<192.168.37.159> REMOTE_MODULE command hostname #远程执行命令hostname
<192.168.37.159> EXEC /bin/sh -c 'mkdir -p $HOME/.ansible/tmp/ansible-tmp-1455684626.83-94958346638443 && echo $HOME/.ansible/tmp/ansible-tmp-1455684626.83-94958346638443' #生成临时临时目录用于存放Ansible远程执行脚本
<192.168.37.159> PUT /tmp/tmp5sawsq TO /root/.ansible/tmp/ansible-tmp-1455684626.83-94958346638443/command #改名临时脚本并存放至临时目录
<192.168.37.159> EXEC /bin/sh -c 'sudo -k && sudo -H -S -p "[sudo via ansible, key=urvzacjxvaagwvlrywymxpxfhjkirkqb] password: " -u root /bin/sh -c '"'"'echo BECOME-SUCCESS-urvzacjxvaagwvlrywymxpxfhjkirkqb; LANG=C LC_CTYPE=C /usr/bin/python /root/.ansible/tmp/ansible-tmp-1455684626.83-94958346638443/command; rm -rf /root/.ansible/tmp/ansible-tmp-1455684626.83-94958346638443/ >/dev/null 2>&1'"'"'' #使用sudo方式并以Python脚本方式执行命令
192.168.37.159 | success | rc=0 >> #返回结果为success,CodeResult为0
Linuxlst #返回的命令返回结果如下
使用-vvv参数可以清楚了解Ansible命令执行流程,执行流程如图3-3所示
图3-3 Ansible命令执行流程图
情景3
列出Web组所有主机列表
执行命令:
ansible web --list
返回结果如下:
10.3.33.21
10.3.33.23
执行结果诠释:
--list选项列出web组所有主机列表信息,Web组中包括 10.3.33.21 和 10.3.33.23两台主机。
Ok,接下来我们模拟较为复杂的场景:
情景4:
对10.21.40.61服务器以root执行sleep 20,并设置最大连接超时时长为2s,且设置为后台运行模式,执行过程每2s输出一次进度,如5s还未执行完则kill终止该任务
执行命令:
//(注:time命令可省,为方便观察结果这里使用time命令查看执行时长)
time ansible 10.21.40.61 -B 5 -P 2 -T 2 -m command -a 'sleep 20' -u root
返回结果如下图所示:
图3-4 结果返回
执行结果诠释:
第一行:[WARNING]不用理会,需升级gmp,该提醒不影响命令返回结果如下
第二行:background launch...表示使用-B使该命令后台运行
每隔2s输出一次执行进度
<job 182625384959.32339> polling on 10.21.40.61, 3s remaining表示执行时长剩余3s
每隔2s输出一次执行进度
<job 182625384959.32339> polling on 10.21.40.61, 1s remaining表示执行时长剩余1s
real 0m10.268s程序执行总时长
user 0m1.898s系统用户层执行时长
sys 0m0.163s系统内核层执行时长
3.2.2 通过Ad-Hoc查看系统设置
上节为大家介绍了Ad-Hoc的命令集用法,本节我们通过df,free命令查看系统设置,但是是通过Ad-Hoc实现,在此过程中了解Ansible。我们模拟如下两个场景:
情景1:
批量查看apps组所有主机的磁盘容量(使用command模块)。
执行命令:
ansible apps -a "df -lh"
返回结果如下:
192.168.37.130 | success | rc=0 >>
Filesystem Size Used Avail Use% Mounted on
/dev/mapper/vg_linuxlst-lv_root
19G 3.6G 14G 21% /
tmpfs 123M 0 123M 0% /dev/shm
/dev/sda1 485M 29M 431M 7% /boot
192.168.37.155 | success | rc=0 >>
Filesystem Size Used Avail Use% Mounted on
/dev/mapper/vg_linuxlst-lv_root 18G 4.9G 12G 30% /
tmpfs 144M 0 144M 0% /dev/shm
/dev/sda1 485M 33M 427M 8% /boot
192.168.37.142 | success | rc=0 >>
Filesystem Size Used Avail Use% Mounted on
/dev/mapper/vg_linuxlst-lv_root 18G 5.4G 12G 33% /
tmpfs 144M 0 144M 0% /dev/shm
/dev/sda1 485M 33M 427M 8% /boot
192.168.37.156 | success | rc=0 >>
Filesystem Size Used Avail Use% Mounted on
/dev/mapper/vg_linuxlst-lv_root 8.4G 6.4G 1.6G 81% /
tmpfs 140M 0 140M 0% /dev/shm
/dev/sda1 485M 35M 426M 8% /boot
/dev/sdb5 20G 3.0G 16G 16% /data2
执行结果诠释:
以192.168.37.130的返回为例,success表示命令执行成功,rc=0表示ResultCode=0即命令返回结果如下返回码为0,表示命令执行成功,>>后面跟的内容相当于在主机本地执行df –lh后的结果返回。
情景2:
批量查看远程主机内存使用情况 (shell模块)
执行命令:
ansible apps -m shell -a "free -m"
返回结果如下:
192.168.37.142 | success | rc=0 >>
total used free shared buffers cached
Mem: 286 282 4 0 34 119
-/+ buffers/cache: 128 158
Swap: 2015 668 1347
192.168.37.130 | success | rc=0 >>
total used free shared buffers cached
Mem: 244 188 56 0 30 101
-/+ buffers/cache: 56 187
Swap: 1023 0 1023
192.168.37.155 | success | rc=0 >>
total used free shared buffers cached
Mem: 286 217 69 0 84 63
-/+ buffers/cache: 68 218
Swap: 2015 0 2015
192.168.37.156 | success | rc=0 >>
total used free shared buffers cached
Mem: 279 251 28 0 29 33
-/+ buffers/cache: 188 91
Swap: 1023 22 1001
执行结果诠释:
以192.168.37.142的返回为例,success表示命令执行成功,rc=0表示ResultCode=0即命令返回结果如下返回码为0,表示命令执行成功,>>后面跟的内容相当于在主机本地执行free-m后的结果返回。
通过上面两个场景的示例相信大家对Ad-Hoc的用法有一定的了解,接下来的章节我们更进一步学习Ad-Hoc的并发特性。
3.2.3 通过Ad-Hoc研究Ansible的并发特性
如3.2.1节所示,Ansible和Ansible-playbook默认会 fork 5个线程并发执行命令,但在实际工作中,如果主机数量众多,Ansible并发5个线程是远不能满足企业所需,所以本节我们带大家了解Ansible的并发特性。我们通过如下测试来更深入了解Ansible的并发工作模式。
场景如下:
我们定义[apps]组,多次执行同样的Ad-Hoc命令来查看其返回的结果,执行步骤如下。
步骤1
定义[apps]组,编辑/etc/ansible/hosts的配置,在文件示添加如下配置,执行命令 vi /etc/ansible/hosts键入i进行vi编辑模式跳转到文件最末尾添加如下配置:
[apps]
192.168.37.130
192.168.37.155
192.168.37.142
192.168.37.156
步骤2
多次执行Ansible命令,执行命令如下:
ansible apps -m ping -f 3
步骤3
对比返回结果。
表3-1 返回结果如下对比
返回结果如下分析:
1)同样的命令多次执行但每次的输出结果都不一定一样。
2)输出结果不是按照/etc/ansible/hosts中 [apps]定义的主机按序输出。
3)结果输出基本上遵循每次输出3条记录(线程池始终保持3个线程,所以这里如果每次输出小于等于3都是正常的哦)。
OK,通过上面的实验我们对Ansible并发特性有概念性的了解,回到前面的问题,企业实际应用中,如主机数量诸多我们需调大线程数该如何操作呢?这里Ansible为我们提供了便捷的选项,如3.2.1节所讲, -f 指定线程数,如-f 1表示并发启动一个线程,-f 10则表示同时启动10个线程并发执行命令。其实查看源码可知Ansible使用multiprocessing管理多线程。
3.2.4 通过Ad-Hoc研究Ansible的模块使用
前面的章节为大家详细介绍了Ad-Hoc的命令集使用方法及其他并发特性等,那Ansible究竟有多少现成功能可供大家使用呢?本节来为大家介绍Ad-Hoc的模块使用。
截止本篇编写时间(2016-02-11),官方呈现的所有可用模块约 468 个(2016-08-19所有可用模块约622个,短短6个月增加了154个,也可见Ansible的发展速度),所有模块官方也做了详尽的功能分类。明细可参考官方链接。另外,Ansible也提供了类似man功能的help说明工具ansible-doc ,直接回车或 -h 显示功能用法,和Linux下系统下的man命令一样重要,正式学习Ansible模块使用前,有必要先来了解ansible-doc 用法.
命令用法:
ansible-doc [options] [module...]
可用选项:
--version
:显示工具版本号。-h, --help
:显示该help说明。-M MODULE_PATH, --module-path=MODULE_PATH
:指定Ansible模块的默认加载目录。-l, --list
:列出所有可用模块。-s, --snippet
:只显示playbook说明的代码段。-v
:等同—version显示工具版本号。
应用情景1:
显示所有可用模块
执行命令:
ansible-doc –l
返回结果如下:
a10_server Manage A10 Networks AX/SoftAX/Thunder/vThunder devices
a10_service_group Manage A10 Networks AX/SoftAX/Thunder/vThunder devices
a10_virtual_server Manage A10 Networks AX/SoftAX/Thunder/vThunder devices
acl Sets and retrieves file ACL information.
add_host add a host (and alternatively a group) to the ansible-playboo...
airbrake_deployment Notify airbrake about app deployments
alternatives Manages alternative programs for common commands
apache2_module enables/disables a module of the Apache2 webserver
apt Manages apt-packages
apt_key Add or remove an apt key
apt_repository Add and remove APT repositories
apt_rpmapt_rpm package manager
arista_interface Manage physical Ethernet interfaces
arista_l2interface Manage layer 2 interfaces
arista_lag Manage port channel (lag) interfaces
arista_vlan Manage VLAN resources
assemble Assembles a configuration file from fragments
…
应用情景2:
以yum模块为例,我们希望获取yum模块的HELP说明
执行命令:
ansible-doc yum
返回结果如下:
> YUM
Installs, upgrade, removes, and lists packages and groups with the
`yum' package manager.
Options (= is mandatory):
- conf_file
The remote yum configuration file to use for the transaction.
[Default: None]
…
其他模块HELP说明以此类推即可,下面通过Ansible内置模块来完成一些具体工作。
示例1
步骤1: 安装redhat-lsb并查看服务器系统版本号
执行命令:
ansible apps -m yum -a 'name=redhat-lsb state=present'
返回结果如下:
192.168.37.142 | success >> {
"changed": false,
"msg": "",
"rc": 0,
"results": [
"redhat-lsb-4.0-7.el6.centos.i686 providing redhat-lsb is already installed"
]
}
…
部分执行结果诠释:
"changed"
: 主机是否有变更 true:有 false:没有 (第一次运行或事先没有安装,返回值一般是true,否则为false)"msg"
:安装过程信息"rc"
: 0,rc英文全称是“resultcode”,中文是“结果返回码”的意思,非0返回码往往是红色并且错误的返回,非常明显
步骤2: 查看系统版本号
执行命令
ansible apps -m command -a 'lsb_release -a'
返回结果如下:
192.168.37.155 | success | rc=0 >>
LSB Version: :base-4.0-ia32:base-4.0-noarch:core-4.0-ia32:core-4.0-noarch:graphics-4.0-ia32:graphics-4.0-noarch:printing-4.0-ia32:printing-4.0-noarch
Distributor ID: CentOS
Description: CentOS release 6.5 (Final)
Release: 6.5
Codename: Final
…
部分执行结果诠释:
192.168.37.155:表示命令执行的对象;
success:表示命令执行的返回状态为成功状态;
rc=0:表示命令执行的状态码为0 ;
>> 该符号后返回的所有内容为执行lsb_release –a 命令返回的信息;
LSB Version: 表示该系统的内核版本信息;
Distributor ID:表示发行厂商;
Description:表示版本简要信息;
Release:表示该系统的发行版本号;
Codename:表示发行版本代号;
示例2
为所有服务器安装ntp服务并设置为开机启动
步骤1:安装ntp服务
执行命令:
ansible apps -s -m yum -a "name=ntp state=present"
步骤2:启动ntp服务并设置为开机启动
执行命令:
ansible apps -m service -a "name=ntpd state=started enabled=yes"
返回的结果不再一一为大家列举出来,相信上面那么多的示例,大家对如何判断结果是否正确有准备的了解了。
《运维前线》新书发布,十三位前线运维专家倾力奉献,现场送出30本。云技术社区、华章书院、优云联手倾力精彩奉献!现场另有云技术社区定制数据线、北极熊袋子等精美礼品!2017年首场专业运维会议,一线专家解密当前运维前线,扫码或者点击阅读原文立即报名!
加入云技术社区技术交流微信群,联系北极熊微信:hadxiaer(加的时候请备注:姓名-城市-公司)
交流 分享 提升
以上是关于Ansible Ad-Hoc命令集的主要内容,如果未能解决你的问题,请参考以下文章