cron模块
主要作用
cron 模块可以帮助我们管理远程主机中的计划任务,功能相当于 crontab 命令。
功能参数及应用举例
其中,minute、hour、day、month、weekday参数相似,以minute参数为例。
minute参数:此参数用于设置计划任务中分钟设定位的值,比如,上述示例1中分钟设定位的值为5,即 minute=5,当不使用此参数时,分钟设定位的值默认为”*”。
#在test主机上添加名为crontab test的echo hello计划任务,每五分钟执行一次 [root@tlur31drk8wk ~]# ansible test -m cron -a "name='crontab test' minute=5 job='echo hello'" 192.168.161.51 | SUCCESS => { "changed": true, "envs": [], "jobs": [ "crontab test" ] } #执行后test主机计划任务如下 [root@s4r3kxlr7bms ~]# crontab -l #Ansible: crontab test 5 * * * * echo hello
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(每时)。
#在test主机上添加名称为special time test的echo hello计划任务,重启时执行 [root@tlur31drk8wk ~]# ansible test -m cron -a "name='special time test' special_time=reboot job='echo hello'" 192.168.161.51 | SUCCESS => { "changed": true, "envs": [], "jobs": [ "crontab test", "special time test" ] } #执行后test主机的计划任务如下: [root@s4r3kxlr7bms ~]# crontab -l #Ansible: crontab test 5 * * * * echo hello #Ansible: special time test @reboot echo hello
注意:当上述时间单位设定参数都未指定时,计划任务的时间设定默认会被设定为”* * * * *”,这样表示每秒都会执行一次计划任务,所以,在使用cron模块时,我们应该确定对应的时间参数设置正确。
user参数:此参数用于设置当前计划任务属于哪个用户,当不使用此参数时,默认为管理员用户。
job参数:此参数用于指定计划的任务中需要实际执行的命令或者脚本,比如上例中的 “echo test” 命令。
name参数:此参数用于设置计划任务的名称,计划任务的名称会在注释中显示,当不指定计划任务的名称时,ansible 会默认为计划任务加入注释,注释的内容为 #Ansible: None,假设指定计划任务的名称为 test,那么注释的内容为#Ansible: test,在一台机器中,计划任务的名称应该具有唯一性,方便我们以后根据名称修改或删除计划任务。
state参数:当计划任务有名称时,我们可以根据名称修改或删除对应的任务,当删除计划任务时,需要将 state 的值设置为 absent。
# [root@tlur31drk8wk ~]# ansible test -m cron -a "name='special time test' state=absent" 192.168.161.51 | SUCCESS => { "changed": true, "envs": [], "jobs": [ "crontab test" ] } # [root@s4r3kxlr7bms ~]# crontab -l #Ansible: crontab test 5 * * * * echo hello
disabled参数:当计划任务有名称时,我们可以根据名称使对应的任务”失效”(注释掉对应的任务)。注意,使用此参数时,除了需要指定任务的名称,还需要同时指定任务的job 以及任务的时间设定,而且任务的时间设定必须和对应任务完全相同,否则在注释任务的同时,任务的时间设定会被修改,除非你确定这样做。
#注释掉test主机中名称为crontab test的计划任务 [root@tlur31drk8wk ~]# ansible test -m cron -a "name='crontab test' minute=5 job='echo hello' disabled=yes backup=yes" 192.168.161.51 | SUCCESS => { "backup_file": "/tmp/crontab0ZIIiI", "changed": true, "envs": [], "jobs": [ "crontab test" ] } #执行后test主机计划任务如下 [root@s4r3kxlr7bms ~]# crontab -l #Ansible: crontab test #5 * * * * echo hello
backup参数:如果此参数的值设置为 yes,那么当修改或者删除对应的计划任务时,会先对计划任务进行备份,然后再对计划任务进行修改或者删除,cron 模块会在远程主机的 /tmp 目录下创建备份文件,以 crontab 开头并且随机加入一些字符,具体的备份文件名称会在返回信息的 backup_file 字段中看到,推荐将此此参数设置为 yes。
service模块
主要作用
service 模块可以帮助我们管理远程主机上的服务。比如,启动或停止远程主机中的 nginx 服务。
注意:假如想要管理远程主机中的某个服务,那么这个服务必须能被 BSD init, OpenRC, SysV, Solaris SMF, systemd, upstart 中的任意一种所管理,否则 service 模块也无法管理远程主机的对应服务。这样说可能不容易理解,那么我们换个方式来解释,假设你在使用 centos6,那么你的 centos6 中的 nginx 必须能够通过 “service nginx start” 启动,如果你的 nginx 无法通过 “service nginx start” 进行启动,那么它也同样无法通过 ansible 的 service 模块启动。假设你在使用 centos7,那么你的 centos7 中的 nginx 则必须能够通过 “systemctl start nginx” 启动,如果它无法通过 “systemctl start nginx” 进行启动,那么它也同样无法通过 ansible 的 service 模块进行启动。centos6 中默认通过 sysv 管理服务,centos7 中默认通过 systemd 管理服务。所以,如果服务无法通过 BSD init, OpenRC, SysV, Solaris SMF, systemd, upstart 中的任意一种所管理,那么它也无法被ansible 的 service 模块管理。
功能参数及应用举例
name参数:此参数用于指定需要操作的服务名称,比如 nginx。
state参数:此参数用于指定服务的状态,比如,我们想要启动远程主机中的 nginx,则可以将 state 的值设置为 started;如果想要停止远程主机中的服务,则可以将 state 的值设置为 stopped。此参数的可用值有 started、stopped、restarted、reloaded。
#停止test主机的nginx服务 [root@tlur31drk8wk ~]# ansible test -m service -a "name=nginx state=stopped" 192.168.161.51 | SUCCESS => { "changed": true, "name": "nginx", "state": "stopped" } #test主机的nginx状态 [root@s4r3kxlr7bms ~]# service nginx status nginx is stopped.
enabled参数:此参数用于指定是否将服务设置为开机 启动项,设置为 yes 表示将对应服务设置为开机启动,设置为 no 表示不会开机启动。
#关闭test主机nginx开机自动启动 [root@tlur31drk8wk ~]# ansible test -m service -a "name=nginx enabled=no" 192.168.161.51 | SUCCESS => { "changed": true, "enabled": false, "name": "nginx" } #test主机nginx开机启动状态 [root@s4r3kxlr7bms ~]# chkconfig --list nginx nginx 0:off 1:off 2:off 3:off 4:off 5:off 6:off