community.general.cronvar – Manage variables in crontabs

Note

This plugin is part of the community.general collection (version 1.3.2).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.cronvar.

Synopsis
Requirements
Parameters
Examples

Synopsis

Use this module to manage crontab variables.
This module allows you to create, update, or delete cron variable definitions.

Requirements

The below requirements are needed on the host that executes this module.

cron

Parameters

Parameter	Choices/Defaults	Comments
backup boolean	no ← yes	If set, create a backup of the crontab before it is modified. The location of the backup is returned in the `backup` variable by this module.
cron_file string		If specified, uses this file instead of an individual user's crontab. Without a leading `/`, this is assumed to be in /etc/cron.d. With a leading `/`, this is taken as absolute.
insertafter string		If specified, the variable will be inserted after the variable specified. Used with `state=present`.
insertbefore string		Used with `state=present`. If specified, the variable will be inserted just before the variable specified.
name string / required		Name of the crontab variable.
state string	absent present ←	Whether to ensure that the variable is present or absent.
user string		The specific user whose crontab should be modified. This parameter defaults to `root` when unset.
value string		The value to set this variable to. Required if `state=present`.

Examples

- 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

Authors

Doug Luce (@dougluce)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/cronvar_module.html