cron 模块可以帮助我们管理远程主机中的计划任务，功能相当于 crontab 命令。 ## 1、选项 ### 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、实例 1.在 ansible-demo3 主机上创建计划任务，任务名称为”crontab test”，任务于每天1点5分执行，任务内容为输出test字符。 ``` [root@ansible-manager ~]# ansible ansible-demo3 -m cron -a " name='crontab test' minute=5 hour=1 job='echo test' " ansible-demo3 | SUCCESS => { "changed": true, "envs": [], "jobs": [ "crontab test" ] } ``` 2.在 ansible-demo3 主机上创建计划任务，任务名称为”crontab day test”，任务每3天执行一次，于执行当天的1点1分开始执行，任务内容为输出 test 字符。 ``` [root@ansible-manager ~]# ansible ansible-demo3 -m cron -a " name='crontab day test' minute=1 hour=1 day=*/3 job='echo test' " ansible-demo3 | SUCCESS => { "changed": true, "envs": [], "jobs": [ "crontab test", "crontab day test" ] } ``` 3.在 ansible-demo3 主机上创建计划任务，任务名称为”special time test”，任务将在重启时执行，任务内容为输出 test 字符。 ``` [root@ansible-manager ~]# ansible ansible-demo3 -m cron -a " name='special time test' special_time=reboot job='echo test' " ansible-demo3 | SUCCESS => { "changed": true, "envs": [], "jobs": [ "crontab test", "crontab day test", "special time test" ] } ```