ansible常用模块之 -- cron模块 – 管理cron.d和crontab项

  • cron模块 – 管理cron.d和crontab项
  • 一、摘要
  • 二、参数
  • 三、示例


cron模块 – 管理cron.d和crontab项

一、摘要

  • 使用此模块管理crontab和环境变量项。该模块允许您创建环境变量和命名crontab项、更新或删除它们。
  • 当管理crontab作业时:模块包含一行crontab条目的描述“#Ansible: ”，对应于传递给模块的“name”，它被将来的Ansible /模块调用用来查找/检查状态。“name”参数应该是唯一的，更改“name”值将导致创建一个新的cron任务(或删除一个不同的任务)。
  • 当管理环境变量时，不添加注释行，但是，当模块需要查找/检查状态时，它使用“name”参数查找环境变量定义行。
  • 当使用像%这样的符号时，它们必须正确转义。

二、参数

参数

选项/默认值

描述

backup

boolean

· no ←

· yes

如果设置了，在修改crontab之前创建一个备份。该模块在backup_file变量中返回备份的位置。

cron_file

string

如果指定，则使用此文件而不是单个用户的crontab。

如果这是一个相对路径，它将根据/etc/cron.d进行解释

如果是绝对值，则通常为/etc/crontab。

许多linux发行版期望(有些要求)文件名部分只能由大写字母、小写字母、数字、下划线和连字符组成。

要使用cron_file参数，还必须指定用户。

day

string

Default：“*”

作业应该运行的月份日期(1-31，，/2等)

disabled

boolean

· no ←

· yes

如果作业应该在crontab中被禁用(注释掉)。

只有当state=present时才有效。

env

boolean

· no ←

· yes

如果设置，则管理crontab的环境变量。

在crontab上添加了新变量。

name和value参数分别为环境变量的名称和值。

hour

string

Default：“*”

作业应该运行的小时(0-23、、/2等)

insertafter

string

与state=present和env连用

如果指定了，则将在声明指定的环境变量之后插入环境变量。

insertbefore

string

与state=present和env连用

如果指定了，则将在声明指定的环境变量之前插入环境变量。

job

string

要执行的命令，如果设置了env，则为环境变量的值。

该命令不应该包含换行符。

需设置state=present。

minute

string

Default：“*”

作业应该运行的分钟(0-59、、/2等)

month

string

Default：“*”

作业应该运行的月份(1-12、、/2等)

name

string

crontab项的描述，如果设置了env，则为环境变量的名称。

需要state=absent。

注意，如果没有设置name且state=present，则将始终创建一个新的crontab条目，而不管现有条目是什么。

在以后的版本中，总是需要这个参数。

reboot

boolean

· no ←

· yes

是否应该在重新启动时运行作业。此选项已弃用。用户应该使用special_time。

special_time

string

· annually

· daily

· hourly

· monthly

· reboot

· weekly

· yearly

特殊时间规范昵称。

state

string

· present ←

· absent

是否确保作业或环境变量存在或不存在。

user

string

需要修改crontab的特定用户。

不设置时，默认使用root。

weekday

string

Default：“*”

作业应该运行的星期几(周日-周六为0-6，*等)

三、示例

# 确保在2点整和5点整运行的作业存在。创建类似于"0 5,2 * * * ls -alh > /dev/null"的条目
- name: Ensure a job that runs at 2 and 5 exists. Creates an entry like "0 5,2 * * ls -alh > /dev/null"
  cron:
    name: "check dirs"
    minute: "0"
    hour: "5,2"
    job: "ls -alh > /dev/null"

# 确保以前的工作不再存在。从crontab中删除前缀为“#Ansible: an old job”的任何作业
- name: 'Ensure an old job is no longer present. Removes any job that is prefixed by "#Ansible: an old job" from the crontab'
  cron:
    name: "an old job"
    state: absent

# 创建一个类似于"@reboot /some/job.sh"的条目
- name: Creates an entry like "@reboot /some/job.sh"
  cron:
    name: "a job for reboot"
    special_time: reboot
    job: "/some/job.sh"

# 在crontab顶部创建一个类似“PATH=/opt/bin”的条目
- name: Creates an entry like "PATH=/opt/bin" on top of crontab
  cron:
    name: PATH
    env: yes
    job: /opt/bin

# 创建一个类似"APP_HOME=/srv/app"的条目，并在PATH声明后插入它
- name: Creates an entry like "APP_HOME=/srv/app" and insert it after PATH declaration
  cron:
    name: APP_HOME
    env: yes
    job: /srv/app
    insertafter: PATH

# 在/etc/cron.d下创建cron文件
- name: Creates a cron file under /etc/cron.d
  cron:
    name: yum autoupdate
    weekday: "2"
    minute: "0"
    hour: "12"
    user: root
    job: "YUMINTERACTIVE=0 /usr/sbin/yum-autoupdate"
    cron_file: ansible_yum-autoupdate

# 从/etc/cron.d下删除cron文件
- name: Removes a cron file from under /etc/cron.d
  cron:
    name: "yum autoupdate"
    cron_file: ansible_yum-autoupdate
    state: absent

# 从crontab中删除“APP_HOME”环境变量
- name: Removes "APP_HOME" environment variable from crontab
  cron:
    name: APP_HOME
    env: yes
    state: absent