salt.states.cron之Unix下任务调度命令cron

cron的状态管理需要一些参数来声明，时间参数需要声明：分钟，小时，天，月，星期。用户还要声明该动作是编辑还是新定义。默认情况下，这个时间参数都是”*”，执行用户是”root”，当修改一个当前存在的cron job，这个名字的声明必须是全局唯一的，所以修改当前一个已存在的cron job看想起来像下面这样：

date > /tmp/crontest:
cron.present:
- user: root
- minute: 5

修改为：

date > /tmp/crontest:
cron.present:
- user: root
- minute: 7
- hour: 2

然后现有的这个cron将会被更新，但是如果这个cron命令被改变，那么一个新的cron job将会被添加到这个用户的crontab中。此外，时间参数(分钟，小时等)可以通过使用随机random，而不是使用一个特定的值。例如，在定义cron state中使用random关键字定义minute参数，相同的cron job可以推送到数百或数千台主机，并且他们就分别使用一个随机生成的分钟。当cron job同时访问一个网络资源这将会是很有帮助的，因为所有的主机同时运行这个工作时是不可取的。

/path/to/cron/script:
cron.present:
- user: root
- minute: random
- hour: 2

因为salt假设在未定义的模板参数值都是”*”，当添加一个参数到state并且设置其值为”random”，那么该参数的值将会由随机生成的这个数字代替之前默认的”*”，然而如果这个参数的值在minion上已经是一个具体的数字，那么使用random关键字，将不会修改minion上的配置.

salt.states.cron.absent(name, user='root', **kwargs)

该states可以验证指定的cron job是否在指定的用户下存在，如果name匹配了，将会移除这个匹配到的cron job

name
在用户crontab中不应该出现的命令

user
需要修改的cron用户名字，默认是"root"用户

salt.states.cron.file(name, source_hash='', user='root', template=None, context=None, replace=True, defaults=None, env=None, backup='', **kwargs)

该states提供文件管理功能，为crontab文件预制一个函数(模板等)，分配到某个用户上

name
这个源文件将被用于crontab,这个源文件可以被托管在任何的salt-master上，或者一个HTTP或FTP服务器上。对于托管在salt文件服务器上，如果这个文件位于文件服务器上的一个名为spam的目录下，并且名字为eggs,那么这个源字符串应该是sakt://spam/eggs。如果这个文件托管在HTTP或FTP服务器上，则依赖于source_hash这个参数。

source_hash
这可以使一个文件，其中包含一个源哈希字符串，或者是一个哈希字符串，源哈希字符串是跟在哈希散列算法：
md5=e138491e9d5b97023cea823fe17bac22

user
被设置crontab的用户，默认是root

template
命名模板将会按照模板类型的语法进行渲染下载下来的文件，现在只支持jinja 和 mako

context
覆盖默认的上下文变量传递给模板

replace
如果这个crontab将被替换，如果错误，这条命令将会被忽略，如果对于指定的用户存在一个crontab，默认是True

defaults
默认传递给模板的上下文内容

backup
当覆盖了用户的crontab将会开启备份模式

salt.states.cron.present(name, user='root', minute='*', hour='*', daymonth='*', month='*', dayweek='*')

该states验证指定的cron job是否存在于指定的用户下，关于更多详细设置crontab的参数，请查看系统crontab文档，大多数Unix系统的cron文档，可以使用man 5 crontab的man page中找到

name
应该被执行的cron job的命令

user
需要修改的cron用户名字，默认是"root"用户

minute
这个参数是被设置cron的分钟部分，这里可以是您的系统支持的任何有效的字符串。默认值是 *

hour
这个参数是被设置cron的小时部分，默认值是 *

daymonth
这个参数是被设置cron的天数的部分，默认值是 *

month
这个参数是被设置cron的月份部分，默认值是 *

dayweek
这个参数是被设置cron的星期部分，默认值是 *

附实例一枚：

# cat /srv/salt/top.sls
base:
"*":
- manager.cron

# cat /srv/salt/manager/cron/init.sls
restart_ks.sh:
file.managed:
- source: salt://resource/restart_ks.sh
- name: /usr/local/sbin/restart_ks.sh
jobs:
cron.present:
- name: sh /usr/local/sbin/restart_ks.sh
- user: root
- minute: 40
- hour: 0
- require:
- file.managed: restart_ks.sh

参考文档：http://docs.saltstack.com/ref/states/all/salt.states.cron.html#module-salt.states.cron