community.general.cronvar 模块 – 管理 crontab 中的变量

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 包,则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install community.general。您需要其他需求才能使用此模块,有关详细信息,请参阅 需求

要在 playbook 中使用它,请指定:community.general.cronvar

概要

  • 使用此模块管理 crontab 变量。

  • 此模块允许您创建、更新或删除 cron 变量定义。

需求

执行此模块的主机需要以下需求。

  • cron

参数

参数

注释

backup

布尔值

如果设置,则在修改 crontab 之前创建其备份。备份位置由此模块的 backup 变量返回。

选项

  • false ← (默认)

  • true

cron_file

字符串

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

如果没有前导 /,则假定它位于 /etc/cron.d 中。

如果有前导 /,则将其视为绝对路径。

insertafter

字符串

如果指定,则变量将插入到指定的变量之后。

state=present 一起使用。

insertbefore

字符串

state=present 一起使用。如果指定,则变量将插入到指定的变量之前。

name

字符串 / 必需

crontab 变量的名称。

state

字符串

确保变量存在还是不存在。

选项

  • "absent"

  • "present" ← (默认)

user

字符串

应修改其 crontab 的特定用户。

此参数未设置时默认为 root

value

字符串

为此变量设置的值。

如果 state=present,则需要此参数。

属性

属性

支持

描述

check_mode

支持:不支持

可以在 check_mode 下运行并返回更改状态预测,而无需修改目标。

diff_mode

支持:不支持

处于差异模式时,将返回有关已更改内容(或可能需要在 check_mode 中更改的内容)的详细信息。

示例

- name: Ensure entry like "[email protected]" exists
  community.general.cronvar:
    name: EMAIL
    value: [email protected]

- name: Ensure a variable does not exist. This may remove any variable named "LEGACY"
  community.general.cronvar:
    name: LEGACY
    state: absent

- name: Add a variable to a file under /etc/cron.d
  community.general.cronvar:
    name: LOGFILE
    value: /var/log/yum-autoupdate.log
    user: root
    cron_file: ansible_yum-autoupdate

作者

  • Doug Luce (@dougluce)