Ansible_常用模块
ansible是自动化运维工具,基于Python开发。
mode: ping copy fetch yum shell
command
-bash-4.2# ansible web -m command -a 'chdir=/ ls' chdir相当于cd
-bash-4.2# ansible web -m command -a 'creates=/root/aa.txt ls'
一个文件名,当这个文件存在,则该命令不执行,可以用来做判断,存在aa.txt因此不会执行ls
-bash-4.2# ansible web -m command -a 'removes=/root/aa.txt ls'
一个文件名,这个文件不存在,则该命令不执行，同理
command(这个模块可以直接在远程主机上执行命令,并将结果返回本主机)
不支持管道符
copy
src:被复制到远程主机的本地文件。可以是绝对路径,也可以是相对路径。如果路径是一个目录,则会递归复制
content:用于替换"src",可以直接指定文件的值
dest:必选项,将源文件复制到的远程主机的绝对路径
backup:当文件内容发生改变后,在覆盖之前把源文件备份,备份文件包含时间信息
force:当目标主机包含该文件,但内容不同时,设为"yes",表示强制覆盖;设为"no",表示目标主机的目标位置不存在该文件才复制。默认为"yes"
以上为常用参数，必须熟练
directory_mode:递归设定目录的权限,默认为系统默认权限
others:所有的 file 模块中的选项可以在这里使用
cp a.txt /root/
ansible web -m copy -a 'src=a.txt dest=/root/'
设置权限和文件内容
ansible web -m copy -a 'content="111" dest=/data/name
mode=666'
ansible web -m shell -a 'cat /root/b.txt'
fetch 模块
该模块用于从远程某主机获取（复制）文件到本地。
有两个选项：
dest：用来存放文件的目录
src：在远程拉取的文件，并且必须是一个file，不能是目录
要注意，文件保存的路径是我们设置的接收目录下的被管制主机ip目录下：
将远程下的/data/hello文件，方法到/data下
ansible web -m fetch -a 'src=/data/hello dest=/data'
file
force:需要在两种情况下强制创建软链接，一种是源文件不存在，但之后会建立的情况下；另一种是目标软链接已存在，需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no
group:定义文件/目录的属组。后面可以加上mode：定义文件/目录的权限
owner:定义文件/目录的属主。后面必须跟上path：定义文件/目录的路径
recurse:递归设置文件的属性，只对目录有效，后面跟上
src： 被链接的源文件路径，只应用于state=link的情况
dest:被链接到的路径，只应用于state=link的情况
state:状态，有以下选项：
directory：如果目录不存在，就创建目录
link：创建软链接
hard：创建硬链接
touch：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间
absent：删除目录、文件或者取消链接文件
ln -s aaa.jpg /root/bbb.jpg
ansible web -m file -a 'path=/root/bbb.jpg src=aaa.jpg state=link'
ln /root/aaa.txt /root/bbb.txt
ansible web -m file -a 'path=/root/bbb.jpg src=/root/aaa.jpg state=hard'
rm -rf a
ansible web -m file -a 'path=/root/a state=absent'
cron 模块
该模块适用于管理cron计划任务的。
其使用的语法跟我们的crontab文件中的语法一致，同时，可以指定以下选项：
day= # 日应该运行的工作( 1-31, , /2, )
hour= # 小时 ( 0-23, , /2, )
minute= # 分钟( 0-59, , /2, )
month= # 月( 1-12, *, /2, )
weekday= # 周 ( 0-6 for Sunday-Saturday,, )
job= # 指明运行的命令是什么
name= # 定时任务描述
reboot # 任务在重启时运行，不建议使用，建议使用 special_time
special_time # 特殊的时间范围，参数：reboot（重启时），annually（每年），monthly（每月），weekly（每周），daily（每天），hourly（每小时）
state # 指定状态，present 表示添加定时任务，也是默认设置，absent 表示删除定时任务
user # 以哪个用户的身份执行
ansible web -m cron -a 'name="ntp update every 5 min" minute=*/5
job="/sbin/ntpdate 172.17.0.1 &> /dev/null" '
192.168.37.122 | SUCCESS => {
"changed": true,
"envs": [],
"jobs": [
"ntp update every 5 min"
]
}
192.168.37.133 | SUCCESS => {
"changed": true,
"envs": [],
"jobs": [
"ntp update every 5 min"
]
}
只是强制性的将系统时间设置为ntp服务器时间。如果cpu tick有问题，只是治标不治本。所以，一般配合cron命令，来进行定期同步设置。比如，在crontab中添加：
0 12 * * * * /usr/sbin/ntpdate 192.168.0.1
这样，会在每天的12点整，同步一次时间。ntp服务器为192.168.0.1。
更多用法
删除计划任务
ansible web -m cron -a 'name="df everyday" hour=15 job="df -lh >> /tmp/disk_total &> /dev/null" state=absent'
yum 模块
顾名思义，该模块主要用于软件的安装。
其选项如下：
name= # 所安装的包的名称
state= #present--->安装， latest--->安装最新的, absent---> 卸载软件。****
update_cache # 强制更新yum的缓存
conf_file # 指定远程yum安装时所依赖的配置文件（安装本地已有的包）。
disable_gpg_check # 是否禁止GPG checking，只用于 presentor latest。
disablerepo # 临时禁止使用 yum 库。 只用于安装或更新时。
enablerepo # 临时使用的 yum 库。只用于安装或更新时
ansible web -m yum -a 'name=htop state=present'
service 模块
该模块用于服务程序的管理。
其主要选项如下：
arguments # 命令行提供额外的参数
enabled # 设置开机启动。
name= # 服务名称
runlevel # 开机启动的级别，一般不用指定。
sleep # 在重启服务的过程中，是否等待。如在服务关闭以后等待2秒再启动。(定义在剧本中。)
state # 有四种状态，分别为：started--->启动服务， stopped--->停止服务， restarted--->重启服务， reloaded--->重载配置
ansible web -m service -a 'name=nginx state=started enabled=true'
注意必须有守护进程
/usr/sbin/httpd -s
user 模块
comment # 用户的描述信息
createhome # 是否创建家目录
force # 在使用 state=absent 时, 行为与 userdel –force 一致.
group # 指定基本组
groups # 指定附加组，如果指定为(groups=)表示删除所有组
home # 指定用户家目录
name # 指定用户
non_unique # 该选项允许改变非唯一的用户ID值
password # 指定用户密码
remove # 在使用 state=absent 时, 行为是与 userdel –remove 一致
shell # 指定默认shell
state # 设置帐号状态，不指定为创建，指定值为 absent 表示删除
system # 当创建一个用户，设置这个用户是系统用户。这个设置不能更改现有用户
uid # 指定用户的uid
添加一个用户并指定其 uid
ansible web -m user -a 'name=keer uid=11111'
删除用户
ansible web -m user -a 'name=keer state=absent'
group 模块
该模块主要用于添加或删除组。
gid= # 设置组的GID号
name= # 指定组的名称
state= # 指定组的状态，默认为创建，设置值为absent为删除
system= # 设置值为yes，表示创建为系统组
创建组
ansible web -m group -a 'name=sanguo gid=12222'
删除组
ansible web -m group -a 'name=sanguo state=absent'
script 模块
该模块直接指定脚本的路径即可
>[root@server ~]# vim /tmp/df.sh
#!/bin/bash
date >> /tmp/disk_total.log
df -lh >> /tmp/disk_total.log
[root@server ~]# chmod +x /tmp/df.sh
ansible web -m script -a '/tmp/df.sh'
setup 模块
ansible web -m setup -a 'filter="*mem*"'
[root@server ~]# ansible web -m setup -a 'filter="*mem*"' #查看内存
192.168.37.122 | SUCCESS => {
"ansible_facts": {
"ansible_memfree_mb": 1116,
"ansible_memory_mb": {
"nocache": {
"free": 1397,
"used": 587
},
"real": {
"free": 1116,
"total": 1984,
"used": 868
},
"swap": {
"cached": 0,
"free": 3813,
"total": 3813,
"used": 0
}
},
"ansible_memtotal_mb": 1984
},
"changed": false
}
192.168.37.133 | SUCCESS => {
"ansible_facts": {
"ansible_memfree_mb": 1203,
"ansible_memory_mb": {
"nocache": {
"free": 1470,
"used": 353
},
"real": {
"free": 1203,
"total": 1823,
"used": 620
},
"swap": {
"cached": 0,
"free": 3813,
"total": 3813,
"used": 0
}
},
"ansible_memtotal_mb": 1823
},
"changed": false
}
保存信息
ansible web -m setup -a 'filter="*mem*"' --tree /tmp/facts
[root@server facts]# cat 192.168.37.122
{"ansible_facts": {"ansible_memfree_mb": 1115, "ansible_memory_mb": {"nocache": {"free": 1396, "used": 588}, "real": {"free": 1115, "total": 1984, "used": 869}, "swap": {"cached": 0, "free": 3813, "total": 3813, "used": 0}}, "ansible_memtotal_mb": 1984}, "changed": false}
