耗时近一周，近3万字！ansible的12个常用模块详细介绍，有图！看不懂捶我！！

ansible的12个常用模块介绍

一、ansible 常用命令

1、ansible 命令集

/usr/bin/ansible　 //Ansibe AD-Hoc 临时命令执行工具，常用于临时命令的执行
/usr/bin/ansible-doc   //Ansible 模块功能查看工具
/usr/bin/ansible-galaxy　　//下载/上传优秀代码或Roles模块的官网平台，基于网络的
/usr/bin/ansible-playbook  //Ansible 定制自动化的任务集编排工具
/usr/bin/ansible-pull　　 //Ansible远程执行命令的工具，拉取配置而非推送配置（使用较少，海量机器时使用，对运维的架构能力要求较高）
/usr/bin/ansible-vault　　 //Ansible 文件加密工具
/usr/bin/ansible-console　 //Ansible基于Linux Consoble界面可与用户交互的命令执行工具

其中，我们比较常用的是/usr/bin/ansible和/usr/bin/ansible-playbook，而这里主要讲/usr/bin/ansible的使用。

2、ansible-doc 命令

1）使用ansible-doc命令查看模块用法

注：如果列出的信息较多，可使用空格翻页，或向下的键依次查看，最后输入“q”退出。

ansible-doc yum

2）ansible-doc命令常用于获取模块信息及其使用帮助

//列出所有已安装的模块;注:按q退出
ansible-doc -l
//-s列出yum模块描述信息和操作动作
ansible-doc -s yum  
ansible-doc -s command

注：如果列出的信息较多，可使用空格翻页，或向下的键依次查看，最后输入“q”退出。

二、ansible命令模块

1、command模块

command 模块可以帮助我们在远程主机上执行命令。
注意：使用 command 模块在远程主机中执行命令时，不会经过远程主机的 shell 处理，在使用 command 模块时，如果需要执行的命令中含有重定向、管道符等操作时，这些符号也会失效，比如”<”, “>”, “|”, “;” 和 “&” 这些符号，如果你需要这些功能，可以参考后面介绍的 shell 模块。还有一点需要注意，如果远程节点是 windows 操作系统，则需要使用 win_command 模块。
执行 ansible 时，不加 -m 默认使用 command ，可以在 /etc/ansible/ansible.cfg 中修改。

1）常用参数

可用 ansible-doc command 命令查看模块信息
向下翻到最后查看 EXAMPLES ，输入“q”退出

free_form参数 ：必须参数，指定需要远程执行的命令。需要说明一点，free_form 参数与其他参数（如果想要使用一个参数，那么则需要为这个参数赋值，也就是name=value模式）并不相同。比如，当我们想要在远程主机上执行 ls 命令时，我们并不需要写成”free_form=ls” ，这样写反而是错误的，因为并没有任何参数的名字是 free_form，当我们想要在远程主机中执行 ls 命令时，直接写成 ls 即可。因为 command 模块的作用是执行命令，所以，任何一个可以在远程主机上执行的命令都可以被称为 free_form。

chdir参数 : 此参数的作用就是指定一个目录，在执行对应的命令之前，会先进入到 chdir 参数指定的目录中。

creates参数 ：看到 creates，你可能会从字面上理解这个参数，但是使用这个参数并不会帮助我们创建文件，它的作用是当指定的文件存在时，就不执行对应命令，比如，如果 /testdir/test文件存在，就不执行我们指定的命令。

removes参数 ：与 creates 参数的作用正好相反，它的作用是当指定的文件不存在时，就不执行对应命令，比如，如果 /testdir/tests 文件不存在，就不执行我们指定的命令，此参数并不会帮助我们删除文件。

2）举例

命令格式：ansible [主机] [-m 模块] [-a args]
//所有主机执行data命令，其中all可以换成IP或者分类名称，例：192.168.2.4 / webserver
ansible all -m command -a 'date'
//指定ip执行date
ansible 192.168.2.4 -m command -a 'date'
//指定分组执行date
ansible webserver -m command -a 'date'

#不加-m模块，则默认使用command模块
ansible all -a 'date'
ansible all -a 'ls /root'

2、ping模块

检查指定节点机器是否还能连通，用法很简单，不涉及参数，主机如果在线，则回复pong

可用 ansible-doc ping 命令查看模块信息
向下翻到最后查看 EXAMPLES ，输入“q”退出

ansible all -m ping

3、cron模块

cron 模块可以帮助我们管理远程主机中的计划任务，功能相当于 crontab 命令。
在了解cron模块的参数之前，先写出一些计划任务的示例：
// 示例1，每天的1点5分输出 test 字符
5 1 * * * echo test

// 示例2，每3天执行一次计划任务，于当天的1点1分执行，具体任务为输出 test 字符
1 1 */3 * * echo test

// 示例3，每次系统启动后需要执行一次计划任务，具体任务为输出 test 字符
@reboot echo test

// 示例4，每小时执行一次计划任务，具体任务为输出 test 字符
@hourly echo test

1）cron模块常用参数

可用 ansible-doc cron 命令查看模块信息
向下翻到最后查看 EXAMPLES ，输入“q”退出

`minute`参数：此参数用于设置计划任务中分钟设定位的值，比如，上述示例1中分钟设定位的值为5，即 minute=5，当不使用此参数时，分钟设定位的值默认为”*”。

`hour`参数：此参数用于设置计划任务中小时设定位的值，比如，上述示例1中小时设定位的值为1，即 hour=1，当不使用此参数时，小时设定位的值默认为”*”。

`day`参数：此参数用于设置计划任务中日设定位的值，当不使用此参数时，日设定位的值默认为”*”。

`month`参数：此参数用于设置计划任务中月设定位的值，当不使用此参数时，月设定位的值默认为”*”。

`weekday`参数：此参数用于设置计划任务中周几设定位的值，当不使用此参数时，周几设定位的值默认为”*”。

`special_time`参数：在上述示例3与示例4中，计划任务的时间设定格式为 @reboot 或者@hourly。@reboot 表示重启时执行，@hourly 表示每小时执行一次，相当于设置成”0 0 * * *” ，这种@开头的时间设定格式则需要使用 special_time 参数进行设置，special_time 参数的可用值有 reboot(重启后)、yearly(每年)、annually(每年，与yearly相同)、monthly(每月)、weekly(每周)、daily(每天)、hourly(每时)。

注意：当上述时间单位设定参数都未指定时，计划任务的时间设定默认会被设定为”* * * * *”，这样表示每秒都会执行一次计划任务，所以，在使用cron模块时，我们应该确定对应的时间参数设置正确。

`user`参数：此参数用于设置当前计划任务属于哪个用户，当不使用此参数时，默认为管理员用户。

`job`参数：此参数用于指定计划的任务中需要实际执行的命令或者脚本，比如上例中的 “echo test” 命令。

`name`参数：此参数用于设置计划任务的名称，计划任务的名称会在注释中显示，当不指定计划任务的名称时，ansible 会默认为计划任务加入注释，注释的内容为 //Ansible: None，假设指定计划任务的名称为 test，那么注释的内容为 //Ansible: test，在一台机器中，计划任务的名称应该具有唯一性，方便我们以后根据名称修改或删除计划任务。

`state`参数：当计划任务有名称时，我们可以根据名称修改或删除对应的任务，当删除计划任务时，需要将 state 的值设置为 absent。

`disabled`参数：当计划任务有名称时，我们可以根据名称使对应的任务”失效”（注释掉对应的任务）。注意，使用此参数时，除了需要指定任务的名称，还需要同时指定任务的job 以及任务的时间设定，而且任务的时间设定必须和对应任务完全相同，否则在注释任务的同时，任务的时间设定会被修改，除非你确定这样做。

`backup`参数：如果此参数的值设置为 yes，那么当修改或者删除对应的计划任务时，会先对计划任务进行备份，然后再对计划任务进行修改或者删除，cron 模块会在远程主机的 /tmp 目录下创建备份文件，以 crontab 开头并且随机加入一些字符，具体的备份文件名称会在返回信息的 backup_file 字段中看到，推荐将此此参数设置为 yes。

2）示例

//在 webserver 主机上创建计划任务，任务名称为”crontab test”，任务于每天1点5分执行，任务内容为输出test字符。
ansible webserver -m cron -a