Ansible运维自动化工具19个常用模块使用实例【转】

一、模块列表

1、setup

2、ping

3、file

4、copy

5、command

6、shell

7、script

8、cron

9、yum

10、service

11、group

12、user

13、stat

14、mount

15、fetch

16、synchronize

17、get_url

18、hostname

19、wait_for

二、模块示例

1、setup 功能:搜集系统信息

#通过命令获取所有的系统信息,搜集主机的所有系统信息

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m setup

Ansible运维自动化工具19个常用模块使用实例【转】

注意:/etc/ansible/.hosts 文件的写法很关键,官网也出了相关的说明,只不过官方的文档分版本描述的,稍不注意就掉坑了,具体格式如下:

[xxxx-root]

192.168.1.51 ansible_become=True ansible_become_method=su ansible_become_user=root ansible_become_pass=1111111111

192.168.1.52 ansible_become=True ansible_become_method=su ansible_become_user=root ansible_become_pass=1111111111

#搜集系统信息并以主机名为文件名分别保存在/tmp/facts 目录

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m setup --tree /tmp/facts

Ansible运维自动化工具19个常用模块使用实例【转】

#搜集和内存相关的信息

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m setup -a 'filter=ansible_*_mb'

Ansible运维自动化工具19个常用模块使用实例【转】

#搜集网卡信息

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m setup -a 'filter=ansible_eth[0-2]'

Ansible运维自动化工具19个常用模块使用实例【转】


2、ping 功能:测试网络连通性, ping模块没有参数

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m ping

Ansible运维自动化工具19个常用模块使用实例【转】


3、file 功能:文件属性设置

force:需要在两种情况下强制创建软链接,一种是源文件不存在,但之后会建立的情况下;另一种是目标软链接已存在,需要先取消之前的软链,然后创建新的软链,有两个选项:yes|no

group:定义文件/目录的属组

mode:定义文件/目录的权限

owner:定义文件/目录的属主

path:必选项,定义文件/目录的路径

recurse:递归设置文件的属性,只对目录有效

src:被链接的源文件路径,只应用于state=link的情况

dest:被链接到的路径,只应用于state=link的情况

state包括以下:

directory:如果目录不存在,就创建目录

file:即使文件不存在,也不会被创建

link:创建软链接

hard:创建硬链接

touch:如果文件不存在,则会创建一个新的文件,如果文件或目录已存在,则更新其最后修改时间

absent:删除目录、文件或者取消链接文件

创建软链接:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m file -a "src=/etc/resolv.conf dest=/tmp/resolv.conf state=link"

Ansible运维自动化工具19个常用模块使用实例【转】

删除软连接:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m file -a "path=/tmp/resolv.conf state=absent"

Ansible运维自动化工具19个常用模块使用实例【转】

创建目录(文件):

#
ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m file -a
"path=/root/testfile group=ihavecar owner=ihavecar mode=700
state=directory"

Ansible运维自动化工具19个常用模块使用实例【转】


4、copy 功能:复制文件到远程主机

backup: #在覆盖之前,将源文件备份,备份文件包含时间信息。有两个选项:yes|no

content: #用于替代“src”,可以直接设定指定文件的值

dest: #必选项。要将源文件复制到的远程主机的绝对路径,如果源文件是一个目录,那么该路径也必须是个目录

directory_mode: #递归设定目录的权限,默认为系统默认权限

force: #如果目标主机包含该文件,但内容不同,如果设置为yes,则强制覆盖,如果为no,则只有当目标主机的目标位置不存在该文件时,才复制。默认为yes

others:#所有的file模块里的选项都可以在这里使用

group # 复制到远程主机后,指定文件或目录的属

mode # 复制到远程主机后,指定文件或目录权限,类似与 `chmod’指明如 0644

owner # 复制到远程主机后,指定文件或目录属主

src:被复制到远程主机的本地文件,可以是绝对路径,也可以是相对路径。如果路径是一个目录,它将递归复制。在这种情况下,如果路径使用“/”来结尾,则只复制目录里的内容,如果没有用“/”来结尾,则包含目录在内的整个内容全部复制,类似于rsync。

将本地文件“/etc/ansible/ansible.cfg”复制到远程服务器,设置属主和属组及文件权限

#
ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m copy -a
"src=/etc/ansible/ansible.cfg dest=/tmp/ansible.cfg owner=ihavecar
group=root mode=400"

Ansible运维自动化工具19个常用模块使用实例【转】


5、command 功能:在远程主机上执行命令

Command不适用于有shell变量的情况,也不适用于有管道符或者&&的情况,如果要使用此种情况,那么可以使用shell模块

相关选项如下:

creates:一个文件名,当该文件存在,则该命令不执行

free_form:要执行的linux指令

chdir:在执行指令之前,先切换到该目录

removes:一个文件名,当该文件不存在,则该选项不执行

executable:切换shell来执行指令,该执行路径必须是一个绝对路径

远程执行查询系统负载:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m command -a "uptime"

Ansible运维自动化工具19个常用模块使用实例【转】

如带有管道的,则会如下报错,command是不允许有管道的:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m command -a "uptime | grep 192.168.1.50"

Ansible运维自动化工具19个常用模块使用实例【转】


6、shell 功能:切换到某个shell执行指定的指令

切换到某个shell执行指定的指令,与command不同的是,此模块可以支持命令管道,同时还有另一个模块也具备此功能:raw

chdir # 执行之前,先cd到指定目录在执行命令

creates # 一个文件名,当这个文件存在,则该命令不执行

executable # 切换shell来执行命令,需要使用命令的绝对路径

free_form= # 执行的命令

removes # 一个文件名,这个文件不存在,则该命令不执行

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m shell -a "cat /etc/passwd | grep root"

Ansible运维自动化工具19个常用模块使用实例【转】

可远程执行脚本:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m shell -a "sh /tmp/echo.sh"

Ansible运维自动化工具19个常用模块使用实例【转】


7、script 功能:指定本地的脚本文件,到远程主机运行一次

注意这个模块和shell模块的不同,shell模块是要求客户端上有这个脚本才能执行;script是要求ansible服务端有这个脚本就可以了,执行的时候是不会拷贝这个脚本到客户端的。

creates # 一个文件名,当这个文件存在,则该命令不执行

free_form= # 本地脚本路径

removes # 一个文件名,这个文件不存在,则该命令不执行

ansible端的已有脚本,就只有一条/sbin/ifconfig 命令,该脚本被拿到客户端上执行,并返回结果:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m script -a "/etc/ansible/masterecho.sh"

Ansible运维自动化工具19个常用模块使用实例【转】


8、cron 功能:计划任务管理

backup # 如果设置,创建一个crontab备份

cron_file # 如果指定, 使用这个文件cron.d,而不是单个用户crontab

day # 日应该运行的工作( 1-31, *, */2, etc )

hour # 小时 ( 0-23, *, */2, etc )

job # 指明运行的命令是什么

minute # 分钟( 0-59, *, */2, etc )

month # 月( 1-12, *, */2, etc )

name # 定时任务描述

reboot # 任务在重启时运行,不建议使用,建议使用special_time

special_time # 特殊的时间范围,参数:reboot(重启时),annually(每年),monthly(每月),weekly(每周),daily(每天),hourly(每小时)

state # 指定状态,prsent表示添加定时任务,也是默认设置,absent表示删除定时任务

user # 以哪个用户的身份执行

weekday # 周 ( 0-6 for Sunday-Saturday, *, etc )

定义一个时间任务,每隔3分钟执行一次时间记录任务:

#
ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m cron -a
'name="ntp datatime job" minute=*/3 hour=* day=* month=* weekday=*
job="echo `date` >> /tmp/linshidata.txt"'

Ansible运维自动化工具19个常用模块使用实例【转】

效果如下:

Ansible运维自动化工具19个常用模块使用实例【转】

删除一个时间任务:

#
ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m cron -a
'name="ntp datatime job" minute=*/3 hour=* day=* month=* weekday=*
job="echo `date` >> /tmp/linshidata.txt" state=absent'

Ansible运维自动化工具19个常用模块使用实例【转】


9、yum 功能:软件包安装管理

conf_file # yum的配置文件

disable_gpg_check # 关闭gpg_check

disablerepo # 不启用某个源

enablerepo # 启用某个源

List # 非幂等性命令

name= # 指定要安装的包,如果有多个版本需要指定版本,否则安装最新的包

state # 安装(`present’),安装最新版(`latest’),卸载程序包(`absent’)

指定版本安装包:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m yum -a "name=httpd-devel-2.2.15 state=present"

Ansible运维自动化工具19个常用模块使用实例【转】

指定安装最新版本的包:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m yum -a "name=httpd-devel-2.2.15 state=latest"

Ansible运维自动化工具19个常用模块使用实例【转】

指定rpm包来安装:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m yum -a "name=/usr/local/src/kel.noarch.rpm state=present"

指定远程网址rpm包来进行安装:

#
ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m yum -a
"name=http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6.0.el6.ngx.noarch.rpm
state=present"

删除包:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m yum -a "name=httpd-devel-2.2.15 state=absent"

Ansible运维自动化工具19个常用模块使用实例【转】


10、service 功能:系统服务管理

arguments # 向服务传递的命令行参数

enabled # 设置服务开机自动启动,参数为yes|no

name= # 控制服务的名称

pattern # 如果通过status指令来查看服务的状态时,没有响应,就会通过ps指令在进程中根据该模式进行查找,如果匹配到,则认为该服务依然在运行

runlevel # 设置服务自启动级别

sleep # 如果执行了restarted,则在stop和start之间沉睡几秒钟

state # 启动`started’ 关闭`stopped’ 重新启动 `restarted’ 重载 `reloaded’

设置httpd服务为开机自启动模式,并限制开启httpd服务

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m service -a "name=httpd state=started enabled=yes"

重启httpd服务,中间sleep 10秒钟

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m service -a "name=httpd state=restarted sleep=10"

Ansible运维自动化工具19个常用模块使用实例【转】


11、group 功能:系统用户组管理

gid # 设置组的GID号

name= # 管理组的名称

state # 指定组状态,默认为创建,设置值为absent为删除

system # 设置值为yes,表示为创建系统组

创建一个foo组,指定gid号

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m group -a "name=foo gid=360 system=no"

Ansible运维自动化工具19个常用模块使用实例【转】

删除一个组:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m group -a "name=foo gid=360 system=no state=absent"

Ansible运维自动化工具19个常用模块使用实例【转】


12、user 功能:系统用户账号管理

comment # 用户的描述信息

createhome # 是否创建家目录

force # 在使用`state=absent’时, 行为与`userdel –force’一致.

group # 指定基本组

groups # 指定附加组,如果指定为(‘groups=’)表示删除所有组

home # 指定用户家目录

login_class # 可以设置用户的登录类 FreeBSD, OpenBSD and NetBSD系统.

move_home # 如果设置为`home=’时, 试图将用户主目录移动到指定的目录

name= # 指定用户名

non_unique # 该选项允许改变非唯一的用户ID值

password # 指定用户密码

remove # 在使用 `state=absent’时, 行为是与 `userdel –remove’一致.

shell # 指定默认shell

state #设置帐号状态,不指定为创建,指定值为absent表示删除

system # 当创建一个用户,设置这个用户是系统用户。这个设置不能更改现有用户。

uid #指定用户的uid

update_password # 更新用户密码

添加用户foo,指定密码,设置家目录,不允许远程登录

#
ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m user -a
"name=foo password=123456 home=/home/foo shell=/sbin/nologin"

Ansible运维自动化工具19个常用模块使用实例【转】

彻底删除一个用户,包括家目录:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m user -a "name=foo remove=yes state=absent"


13、stat 功能:获取远程文件信息

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m stat -a "path=/etc/passwd"

Ansible运维自动化工具19个常用模块使用实例【转】


14、mount 功能:配置挂载点

fstype:必选项,挂载文件的类型

name:必选项,挂载点

opts:传递给mount命令的参数

src:必选项,要挂载的文件

state:必选项

present:只处理fstab中的配置

absent:删除挂载点

mounted:自动创建挂载点并挂载之

umounted:卸载

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m mount -a "name=/mnt src=/dev/sda5 fstype=ext4 opts=rostate=present"


15、fetch 功能:文件拉取模块,主要是将远程主机中的文件拷贝到本机中

和copy模块的作用刚刚相反,并且在保存的时候使用hostname来进行保存,当文件不存在的时候,会出现错误,除非设置了选项fail_on_missing为yes

Dest:用来存放文件的目录,例如存放目录为backup,源文件名称为/etc/profile在主机pythonserver中,那么保存为/backup/pythonserver/etc/profile

Fail_on_missing: Yes/no,当源文件不存在的时候,标识为失败

Flat: 允许覆盖默认行为从hostname/path到/file的,如果dest以/结尾,它将使用源文件的基础名称

Src: 在远程拉取的文件,并且必须是一个file,不能是目录

Validate_checksum Yes/no,当文件fetch之后进行md5检查

从远程机器上床送文件到ansible服务器

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m fetch -a "src=/root/123 dest=/root"

Ansible运维自动化工具19个常用模块使用实例【转】

src表示为远程主机上需要传送的文件的路径,dest表示为本机上的路径,在传送过来的文件,是按照IP地址或hostname进行分类,然后路径是源文件的路径,例如上面的最终路径为/root/192.168.1.50/root/123在拉取文件的时候,必须拉取的是文件,不能拉取文件夹

指定路径目录进行保存:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m fetch -a "src=/root/Ssh.py dest=/root/kel/ flat=yes"

在使用参数为flat的时候,如果dest的后缀名为/,那么就会保存在目录中,然后直接保存为文件名,如上例的结果为 dest”: “/root/kel/Ssh.py;

当dest后缀不为/的时候,那么就会直接保存为kel的文件,如上例1所示。主要是在于dest是否已/结尾,从而来区分这是个目录还是路径。


16、synchronize 功能:将主控方/root/a目录推送到指定节点的/tmp目录下

选项说明

archive # 是否采用归档模式同步,即以源文件相同属性同步到目标地址

checksum # 是否效验

compress # 开启压缩,默认为开启

copy_links # 同步的时候是否复制连接

delete # 删除源中没有而目标存在的文件(即以推送方为主)

dest= # 目标地址

dest_port # 目标接受的端口,ansible配置文件中的 ansible_ssh_port 变量优先级高于该 dest_port 变量

dirs # 以非递归的方式传输目录

existing_only # Skip creating new files on receiver.

group # Preserve group

links # Copy symlinks as symlinks.

mode # 模式,rsync 同步的方式 PUSH\PULL,默认都是推送push。如果你在使用拉取pull功能的时候,可以参考如下来实现mode=pull 更改推送模式为拉取模式

recursive # 是否递归 yes/no

rsync_opts # 使用rsync 的参数

rsync_path # 服务的路径,指定 rsync 命令来在远程服务器上运行。这个参考rsync命令的--rsync-path参数,--rsync-path=PATH # 指定远程服务器上的rsync命令所在路径信息

rsync_timeout # 指定 rsync 操作的 IP 超时时间,和rsync命令的 --timeout 参数效果一样.

set_remote_user # put user@ for the remote paths. If you have a custom ssh config to define the remote user for

src=\‘#\‘" # 源,同步的数据源

times #

--exclude=.Git 忽略同步.git结尾的文件

由于模块默认启用了archive参数,该参数默认开启了recursive, links, perms, times, owner,group和-D参数。如果你将该参数设置为no,那么你将停止很多参数,比如会导致如下目的递归失败,导致无法拉取

压缩传输a目录到被控节点:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m synchronize -a 'src=/root/a dest=/tmp/ compress=yes'

注意:主控端的a目录传输到被控节点,文件属性过去被控节点后,只能是remote user的权限,也就是ihavecar的,不能是root的,也不允许传输到ihavecar这个用户无权限的目录下去,不然会报错。

Ansible运维自动化工具19个常用模块使用实例【转】

使用pull模式拉取文件到主控节点:

由于模块,默认都是推送push。因此,如果你在使用拉取pull功能的时候,可以参考如下来实现

mode=pull 更改推送模式为拉取模式。

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m synchronize -a 'mode=pull src=/tmp/a dest=/root/ compress=yes'

注意:从被控节点传目录回到主控节点,可以遵循权限,被控节点端目录的属性是什么,传回主控节点的目录权限就是什么,并不会像push方式那样属性改变成普通用户的。还有一点需要注意的是,从被控节点传输回主控节点,只有一个节点能传输成功,其他的节点都会失败。当然,如果各个被控节点的文件如果不是一样的话,那么各个节点都会传文件回来。那样主控端就会收到各个节点的全部文件。

Ansible运维自动化工具19个常用模块使用实例【转】


17、get_url 功能:将某个url的文件下载到被控节点的某个位置

将simplejson-3.8.2.tar.gz 下载到/tmp/下:

#
ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m get_url -a
"url=https://pypi.python.org/packages/source/s/simplejson/simplejson-3.8.2.tar.gz
dest=/tmp/"

Ansible运维自动化工具19个常用模块使用实例【转】


18、hostname 功能:主要用来修改主机的名称

在查看的时候,主要查看文件/etc/sysconfig/network,重启之后才能生效

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m hostname -a "name=ansible-test"

Ansible运维自动化工具19个常用模块使用实例【转】


19、wait_for 功能:等待一个事件发生或处理完后,再继续运行下面的事情

connect_timeout 默认5秒,在下一个事情发生前等待链接的时间,单位是秒

delay 延时,大家都懂,在做下一个事情前延时多少秒

host 默认127.0.0.1,执行这个模块的host

path 当一个文件存在于文件系统中,下一步才继续。

port 端口号,如8080

state 默认started,对象是端口的时候start状态会确保端口是打开的,stoped状态会确认端口是关闭的

present 对象是文件的时候present或者started会确认文件是存在的,而absent会确认文件是不存在的。

started

stopped

absent

10秒后在当前主机开始检查8000端口,直到端口启动后返回:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m wait_for -a "port=22612 delay=10"

Ansible运维自动化工具19个常用模块使用实例【转】

检查path=/tmp/foo直到文件存在后继续:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m wait_for -a "path=/tmp/foo"

Ansible运维自动化工具19个常用模块使用实例【转】

确认/var/lock/file.lock不存在继续:

# ansible -i /etc/ansible/.hosts-root jr-root -c paramiko -m wait_for -a "path=/var/look/file.lock state=absent"

Ansible运维自动化工具19个常用模块使用实例【转】

本文转自

精心汇总,史上最全-Ansible运维自动化工具19个常用模块使用实例(root用户角度)-Ansible-运维人生 http://www.ywadmin.com/?id=91

上一篇:通用的Bitmap压缩算法,进一步节约内存(推荐)


下一篇:解决CPC撰写文档报错问题“无法获取“AxforApplication”控件的窗口句柄。不支持无窗口的 ActiveX 控件”