Ansible常用模块
一、commands相关模块
1、commands模块
command模块包含如下选项：
creates：一个文件名，当该文件存在，则该命令不执行，反正，则执行。
free_form：要执行的linux指令
chdir：在执行指令之前，先切换到该指定的目录
removes：一个文件名，当该文件存在时，则该选项执行，反之，不执行。
注意：commands模块的执行，在远程主机上，需要有python环境的支持。
该模块通过-a跟上要执行的命令可以直接执行，不过命令里如果有带有特殊字符（"<", ">", "|", "&"等）那么则执行不成功。
2、shell 模块
在远程节点上执行命令，用法和command一样，不过shell模块执行命令的时候使用的是/bin/sh，所以shell模块可以执行任何命令。
ansible 172.16.213.233 -m shell -a 'ps-ef|grepsshd'
ansible 172.16.213.233 -m shell -a 'sh/tmp/install.sh >/tmp/install.log'
上面这个命令是执行远程机器上的脚本，脚本路径为/tmp/install.sh（远程主机上的脚本，非本机的），然后将执行命令的结果存放在远程主机路径/tmp/install.log中，注意在进行保存文件的时候，写上全路径，否则就会保存在登录之后的默认路径中。
官方上说，command用起来更安全，更有可预知性。
3、raw模块
raw模块功能类似与前面说的command、shell能够完成的操作，raw也都能完成。不同的是，raw模块不需要远程主机上的python环境。
ansible要执行自动化操作，需要管理机上装ansible，客户机上也需要安装python，如果客户机上没有安装python模块，那么command、shell模块将无法工作，而
raw却可以正常工作，因此，如果有的机器是没有装python，或者说安装的python版本在python2.4以下，就可以使用raw模块来装python、python-simplejson等。
如果有些机器压根就装不了python的话（比如交换机，路由器等），那么，直接用raw模块是最好的选择。
举例：
ansible 172.16.213.233 -m raw -a "ps-ef|grepsshd|awk'{print \$2}' "
ansible 172.16.213.107 -m raw -a "yum -y install python26" -k
raw模块和comand、shell模块不同的还有：raw没有chdir、creates、removes参数
[root@localhostansible]# ansible 172.16.213.157 -m command -a 'chdir=/tmptouch test1.txt' -k
[root@localhostansible]# ansible 172.16.213.157 -m shell -a 'chdir=/tmptouch test2.txt' -k
[root@localhostansible]# ansible 172.16.213.157 -m raw -a 'chdir=/tmptouch test3.txt' -k
4、script模块
script模块是将管理端的shell脚本拷贝到被管理的远程主机上执行，其原理是先将shell复制到远程主机，再在远程主机上执行，此模块的执行，也不需要远程主机上的python环境。
ansible 172.16.213.233 -m script -a 'sh/tmp/install1.sh >/tmp/install.log'
脚本/tmp/install1.sh在管理端本机上，script 模块执行的时候将脚本传送到远程的172.16.213.233主机中，然后执行这个脚本，同时，将执行的输出日志文件保存在远程主机对应的路径/tmp/install.log下，这里保存日志文件的时候，最好用全路径。
二、其他模块
1、ping模块
测试主机是否是通的，用法很简单，不涉及参数：
[root@361way ~]# ansible 172.16.213.170-m ping
172.16.213.170 | SUCCESS => {
"changed": false,
"ping": "pong"
}
2、file模块
file模块主要用于远程主机上的文件操作，file模块包含如下选项：
force：需要在两种情况下强制创建软链接，一种是源文件不存在但之后会建立的情况下；另一种是目标软链接已存在,需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no
group：定义文件/目录的属组
mode：定义文件/目录的权限
owner：定义文件/目录的属主
path：必选项，定义文件/目录的路径
recurse：递归的设置文件的属性，只对目录有效
src：要被链接的源文件的路径，只应用于state=link的情况
dest：被链接到的目标路径，只应用于state=link的情况
state：有如下几个选项：
directory：表示目录，如果目录不存在，则创建目录。
link：创建软链接
hard：创建硬链接
touch：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间
absent：删除目录、文件或者取消链接文件。
使用示例：
ansible 172.16.213.233 -m file -a "path=/mnt/abc123 state=directory"
ansible 172.16.213.233 -m file -a "path=/mnt/abc123 owner=nobody group=nobody mode=0644 recurse=yes"
ansible 172.16.213.233 -m file -a "path=/mnt/syncfile.txt owner=sshdgroup=sshdmode=0644"
ansible 172.16.213.233 -m file -a "path=/mnt/syncfile.txt mode=0444"
ansible 172.16.213.233 -m file -a "src=/etc/ssh/sshd_configdest=/mnt/sshd_configowner=sshdstate=link"
ansible 172.16.213.233 -m file -a "path=/tmp/backup.tar.gz state=absent"
ansible 172.16.213.233 -m file -a "path=/tmp/ansibletempstate=touch"
3、copy模块
Copy模块用于复制文件到远程主机，copy模块包含如下选项：
backup：在覆盖之前将原文件备份，备份文件包含时间信息。有两个选项：yes|no
content：用于替代"src",可以直接设定指定文件的值
dest：必选项。要将源文件复制到的远程主机的绝对路径，如果源文件是一个目录，那么该路径也必须是个目录
directory_mode：递归的设定目录的权限，默认为系统默认权限
force：如果目标主机包含该文件，但内容不同，如果设置为yes，则强制覆盖，如果为no，则只有当目标主机的目标位置不存在该文件时，才复制。默认为yes
others：所有的file模块里的选项都可以在这里使用
src：要复制到远程主机的文件在本地的地址，可以是绝对路径，也可以是相对路径。如果路径是一个目录，它将递归复制。在这种情况下，如果路径使用"/"来结尾，则只复制目录里的内容，如果没有使用"/"来结尾，则包含目录在内的整个内容全部复制，类似于rsync。
copy模块举例：
ansible 172.16.213.233 -m copy -a 'src=/etc/sudoersdest=/app/sudoersowner=root group=root mode=440 backup=yes'
ansible 172.16.213.233 -m copy -a "src=/etc/sudoersdest=/app/sudoersvalidate='visudo-cf%s'"
ansible 172.16.213.233 -m copy -a 'src=/etc/yum dest=/app/ owner=root group=root directory_mode=644'
ansible 172.16.213.233 -m copy -a 'src=/etc/yum/ dest=/app/bakowner=root group=root directory_mode=644'
4、service模块
用于管理远程主机上的服务，该模块包含如下选项：
enabled：是否开机启动yes|no
name：必选项，服务名称
pattern：定义一个模式，如果通过status指令来查看服务的状态时，没有响应，就会通过ps指令在进程中根据该模式进行查找，如果匹配到，则认为该服务依然在运行
sleep：如果执行了restarted，在则stop和start之间沉睡几秒钟
state：对当前服务执行启动，停止、重启、重新加载等操作（started,stopped,restarted,reloaded）
使用示例：
ansible172.16.213.233 -m service -a "name=httpdstate=started"
ansible172.16.213.233 -m service -a "name=httpdenabled=yes"
5、cron模块
用于管理计划任务，包含如下选项：
backup：对远程主机上的原任务计划内容修改之前做备份
cron_file：用来指定一个计划任务文件，也就是将计划任务写到远程主机上/etc/cron.d目录下，创建一个文件对应的计划任务。
day：日（1-31，*，*/2,……）
hour：小时（0-23，*，*/2，……）
minute：分钟（0-59，*，*/2，……）
month：月（1-12，*，*/2，……）
weekday：周（0-7，*，……）
job：要执行的任务，依赖于state=present
name：定义定时任务的描述信息
special_time：特殊的时间范围，参数：reboot（重启时）,annually（每年）,monthly（每月）,weekly（每周）,daily（每天）,hourly（每小时）
state：确认该任务计划是创建还是删除,有两个值可选，分别是present和absent，present表示创建定时任务，absent表示删除定时任务，默认为present。
user：以哪个用户的身份执行job指定的任务。
使用示例：
ansible172.16.213.233 -m cron-a 'name="job for reboot" special_time=reboot job="/data/bootservice.sh"'
ansible172.16.213.233 -m cron-a 'name="yum autoupdate" weekday="6" minute=20 hour=1 user="root" job="yum -y update"'
ansible172.16.213.233 -m cron-a 'backup="True" name="autobackup" weekday="6" minute=30 hour=1 user="root" job="/home/ixdba/backup.sh"'
ansible172.16.213.233 -m cron-a 'name="checkhttp" minute=30 hour=12 user="root" job="/home/ixdba/check_http.sh" cron_file="check_http_for_ansible" '
ansible172.16.213.233 -m cron-a 'name="yum autoupdate" state=absent'
6、yum模块
使用yum包管理器来管理软件包，其选项有：
config_file：yum的配置文件
disable_gpg_check：关闭gpg_check
disablerepo：不启用某个源
enablerepo：启用某个源
name：要进行操作的软件包的名字，也可以传递一个url或者一个本地的rpm包的路径
state：表示要安装还是删除软件包，要安装软件包，可选择present（安装）、installed（安装）、latest（安装最新版本），删除软件包可选择absent、removed。
示例如下：
ansible172.16.213.77 -m yum -a "name=redisstate=installed"
ansible172.16.213.77 -m yum -a "name=redisstate=removed"
ansible172.16.213.77 -m yum -a "name=redisstate=latest enablerepo=epel"
ansible172.16.213.77 -m yum -a " name=http://mirrors.aliyun.com/centos/7.4.1708/os/x86_64/Packages/bash-4.2.46-28.el7.x86_64.rpm state=present "
7、user模块与group模块
user模块是请求的是useradd, userdel, usermod三个指令，goup模块请求的是groupadd, groupdel, groupmod三个指令。
name # 指定用户名
group # 指定用户的主组
groups # 指定附加组，如果指定为('groups=')表示删除所有组。
shell # 指定默认shell
state #设置帐号状态，不指定为默认为present，表示创建，指定值为absent表示删除
remove #当使用状态为state=absent时使用，类似于userdel--remove选项。
示例：
ansible172.16.213.77 -m user -a "name=testuser1"
ansible172.16.213.77 -m user -a "name=testuser2 groups=admins,developers" //添加用户时，同时添加附组
ansible172.16.213.77 -m user -a "name=testuser3 state=absent remove=yes" //删除用户的同时，删除用记家目录
批量修改用户密码：
echo "123456" | opensslpasswd-1 -salt $(< /dev/urandomtr-dc '[:alnum:]' | head -c 32) -stdin
$1$yjJ74Wid$x0QUaaHzA8EwWU2kG6SRB1
ansible172.16.213.77 -m user -a 'name=testuser1 password="$1$Kklap7y3$3AYJdqrcmZUMt9W2/MYE4." '
-1：表示采用的是MD5加密算法。
-salt：指定salt值。在使用加密算法进行加密时，即使密码一样，salt不一样，所计算出来的hash值也不一样，除非密码一样，salt值也一样，计算出来的hash值才一样。
"< /dev/urandomtr-dc '[:alnum:]' | head -c 32"产生一个随机的salt。
passwd的值不能是明文，passwd关键字后面应该是密文，且密文将被保存在/etc/shadow文件中。
8、synchronize模块
此模块通过调用rsync进行文件或目录同步。
archive:归档，相当于同时开启recursive(递归)，links,perms,itmes,owner,group,-D选项都为yes,默认该选项为开启
checksum:跳过检测sum值，默认关闭
compress:是不开启压缩，默认开启
copy_links:复制链接文件，默认为no,注意后面还有一个links参数
delete:删除不存在的文件，默认为no
dest:目录路径
dest_prot:默认为22，ssh协议
mode:push和pull模块，push模块的话，一般用于从本机向远程主机上传文件，pull模式用于从远程主机上拉取文件
示例：
ansible172.16.213.77 -m synchronize -a 'src=/mnt/a dest=/tmp'
ansible172.16.213.77 -m synchronize -a 'mode=pull src=/mnt/a dest=/tmp
9、setup模块
setup模块，主要用于获取主机信息，在playbooks里经常会用到的一个参数gather_facts就与该模块相关。setup模块下经常使用的一个参数是filter参数，具体使用示例如下（由于输出结果较多，这里只列命令不写结果）：
[root@linux~]# ansible172.16.213.77 -m setup -a 'filter=ansible_*_mb' //查看主机内存信息
[root@linux~]# ansible172.16.213.77 -m setup -a 'filter=ansible_em[1-2]' //查看地接口为em1-2的网卡信息
[root@linux~]# ansible all -m setup --tree /tmp/facts //将所有主机的信息输入到/tmp/facts目录下，每台主机的信息输入到主机名文件中（/etc/ansible/hosts里的主机名）
10、get_url模块
该模块主要用于从http、ftp、https服务器上下载文件（类似于wget），主要有如下选项：
sha256sum：下载完成后进行sha256 check；
timeout：下载超时时间，默认10s
url：下载的URL
url_password、url_username：主要用于需要用户名密码进行验证的情况
use_proxy：表示使用代理，代理需事先在环境变更中定义
示例：
ansible172.16.213.77 -m get_url-a "url=http://172.16.213.157/Python-2.7.14.tgz dest=/mnt/python-2.7.14.tgz"
