一、模块列表
二、模块示例
1、setup (搜集系统信息)
搜集主机的所有系统信息
ansible 192.168.31.39 -m setup
搜集系统信息并以主机名为文件名分别保存在 /tmp/facts 目录
root@zhydesktop:/opt/ansible# ansible 192.168.31.39 -m setup --tree /tmp/facts
搜集内存相关的信息
搜集网卡信息
ansible 192.168.31.39 -m setup -a 'filter=ansible_eth[0-2]'
2、ping (测试网络连通性, ping模块没有参数)
3、file (文件属性设置)
创建软链接
删除软连接
创建目录(文件)
4、copy (复制文件到远程主机)
复制文件到远程服务器
将本地文件 “/etc/ansible/ansible.cfg” 复制到远程服务器,设置属主和属组及文件权限
5、command (在远程主机上执行命令)
注意:Command 不适用于有 shell 变量的情况,也不适用于有管道符或者 && 的情况,如果要使用此种情况,那么可以使用 shell 模块。
远程执行查询系统负载
6、shell (切换到某个shell执行指定的指令)
切换到某个 shell 执行指定的指令,与 command 不同的是,此模块可以支持命令管道,同时还有另一个模块也具备此功能:raw
远程执行脚本
7、script (指定本地的脚本文件,到远程主机运行一次)
注意:和 shell 模块的不同,shell 模块是要求客户端上有这个脚本才能执行;script 是要求 ansible 服务端有这个脚本就可以了,执行的时候是不会拷贝这个脚本到客户端的。
ansible 端的已有脚本,就只有一条 /tmp/testscript 命令,该脚本被拿到客户端上执行,并返回结果:
8、cron (计划任务管理)
新建一个定时任务
定义一个时间任务,每隔 3 分钟执行一次时间记录任务:
# ansible all -m cron -a 'name="ntp datatime job" minute=*/3 hour=* day=* month=* weekday=* job="echo `date` >> /tmp/linshidata.txt"'
删除一个时间任务
# ansible all -m cron -a 'name="ntp datatime job" minute=*/3 hour=* day=* month=* weekday=* job="echo `date` >> /tmp/linshidata.txt" state=absent'
9、yum (软件包安装管理)
指定版本安装包
# ansible all -m yum -a "name=httpd-devel-2.2.15 state=present"
指定安装最新版本的包
# ansible all -m yum -a "name=httpd-devel-2.2.15 state=latest"
指定 rpm 包来安装
# ansible all -m yum -a "name=/usr/local/src/kel.noarch.rpm state=present"
指定远程网址 rpm 包来进行安装
# ansible all -m yum -a "name=http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6.0.el6.ngx.noarch.rpm state=present"
删除包
# ansible all -m yum -a "name=httpd-devel-2.2.15 state=absent"
10、service (系统服务管理)
设置 httpd 服务为开机自启动模式,并限制开启 httpd 服务
# ansible all -m service -a "name=httpd state=started enabled=yes"
重启 httpd 服务,中间 sleep 10 秒钟
# ansible all -m service -a "name=httpd state=restarted sleep=10"
11、group 功能:系统用户组管理
创建一个 foo 组,指定 gid 号
# ansible all -m group -a "name=foo gid=360 system=no"
删除一个组
# ansible all -m group -a "name=foo gid=360 system=no state=absent"
12、user (系统用户账号管理)
添加用户 foo,指定密码,设置家目录,不允许远程登录
# ansible all -m user -a "name=foo password=123456 home=/home/foo shell=/sbin/nologin"
彻底删除一个用户,包括家目录
# ansible all -m user -a "name=foo remove=yes state=absent"
13、stat (获取远程文件信息)
# ansible all -m stat -a "path=/etc/passwd"
14、mount (配置挂载点)
# ansible all -m mount -a "name=/mnt src=/dev/sda5 fstype=ext4 opts=ro state=present"
15、fetch (将远程主机中的文件拷贝到本机中)
注意:和 copy 模块的作用刚刚相反,并且在保存的时候使用 hostname 来进行保存,当文件不存在的时候,会出现错误,除非设置了选项 fail_on_missing 为 yes。
从远程机器上传送文件到 ansible 服务器
# ansible all -m fetch -a "src=/root/123 dest=/root"
src 表示为远程主机上需要传送的文件的路径,dest 表示为本机上的路径,在传送过来的文件,是按照 IP 地址或 hostname 进行分类,然后路径是源文件的路径,例如上面的最终路径为 /root/192.168.1.50/root/123 在拉取文件的时候,必须拉取的是文件,不能拉取文件夹
指定路径目录进行保存
# ansible all -m fetch -a "src=/root/Ssh.py dest=/root/kel/ flat=yes"
在使用参数为 flat 的时候,如果 dest 的后缀名为 /,那么就会保存在目录中,然后直接保存为文件名,如上例的结果为 dest”: “/root/kel/Ssh.py;当 dest 后缀不为 / 的时候,那么就会直接保存为 kel 的文件,如上所示。主要是在于 dest 是否已 / 结尾,从而来区分这是个目录还是路径。
16、synchronize (将主控方/root/a目录推送到指定节点的/tmp目录下)
由于模块默认启用了 archive 参数,该参数默认开启了 recursive, links, perms, times, owner,group 和 -D 参数。如果你将该参数设置为 no,那么你将停止很多参数,比如会导致如下目的递归失败,导致无法拉取。
压缩传输 a 目录到被控节点
# ansible all -m synchronize -a 'src=/root/a dest=/tmp/ compress=yes'
注意:主控端的 a 目录传输到被控节点,文件属性过去被控节点后,只能是 remote user 的权限,也就是 ihavecar 的,不能是 root 的,也不允许传输到 ihavecar 这个用户无权限的目录下去,不然会报错。
使用 pull 模式拉取文件到主控节点
由于模块,默认都是推送push。因此,如果你在使用拉取pull功能的时候,可以参考如下来实现,mode=pull 更改推送模式为拉取模式。
# ansible all -m synchronize -a 'mode=pull src=/tmp/a dest=/root/ compress=yes'
注意:从被控节点传目录回到主控节点,可以遵循权限,被控节点端目录的属性是什么,传回主控节点的目录权限就是什么,并不会像push方式那样属性改变成普通用户的。还有一点需要注意的是,从被控节点传输回主控节点,只有一个节点能传输成功,其他的节点都会失败。当然,如果各个被控节点的文件如果不是一样的话,那么各个节点都会传文件回来。那样主控端就会收到各个节点的全部文件。
17、get_url (将某个 url 的文件下载到被控节点的某个位置)
将 simplejson-3.8.2.tar.gz 下载到 /tmp/ 下:
# ansible all -m get_url -a "url=https://pypi.python.org/packages/source/s/simplejson/simplejson-3.8.2.tar.gz dest=/tmp/"
18、hostname (主要用来修改主机的名称)
在查看的时候,主要查看文件 /etc/sysconfig/network,重启之后才能生效
# ansible all -m hostname -a "name=ansible-test"
19、wait_for (等待一个事件发生或处理完后,再继续运行下面的事情)
10 秒后在当前主机开始检查 8000 端口,直到端口启动后返回
# ansible all -m wait_for -a "port=22612 delay=10"
检查 path=/tmp/foo 直到文件存在后继续
# ansible all -m wait_for -a "path=/tmp/foo"
确认 /var/lock/file.lock 不存在继续
# ansible all -m wait_for -a "path=/var/look/file.lock state=absent"
20、创建 SSH 免交互登录
Ansible 通过 SSH 对设备进行管理,而 SSH 包含两种认证方式:一种是通过密码认证,另一种是通过密钥对验证。前者必须和系统交互,而后者是免交互登录。如果希望通过 Ansible 自动管理设备,应该配置为免交互登录被管理设备。
[root@zhydesktop ~]# ssh-keygen -t rsa
<!-- 生成密钥对 -->
Generating public/private rsa key pair.Enter file in which to save the key (/root/.ssh/id_rsa):
<!-- 密钥对存放路径v-->
Created directory '/root/.ssh'.Enter passphrase (empty for no passphrase):
<!-- 输入私钥保护密码,直接按Enter键表示无密码 -->
Enter same passphrase again:
<!-- 再次输入 -->
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:cJz6NRTrvMDxX+Jpce6LRnWI3vVEl/zvARL7D10q9WY root@centos01
The key's randomart image is:
+---[RSA 2048]----+
| . . .|
| . . + oo|
| . = o o. oo|
| = * o..+ *|
| . S *.=+=*+|
| . o =+XooE|
| . ..=.++.|
| ..o ..|
| .. o. |
+----[SHA256]-----+
[root@zhydesktop ~]# ssh-copy-id -i .ssh/id_rsa.pub root@192.168.31.39
<!-- 复制公钥到远端192.168.31.39 -->
[root@zhydesktop ~]# ssh-copy-id -i .ssh/id_rsa.pub root@192.168.31.74
<!-- 复制公钥到远端 192.168.31.74 -->