at - Schedule the execution of a command or script file via the at command
New in version 1.5.
Synopsis
- Use this module to schedule a command or script file to run once in the future.
- All jobs are executed in the ‘a’ queue.
Requirements
The below requirements are needed on the host that executes this module.
- at
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
command | A command to be executed in the future. | |
count required | The count of units in the future to execute the command or script file. | |
script_file | An existing script file to be executed in the future. | |
state |
| The state dictates if the command or script file should be evaluated as present(added) or absent(deleted). |
unique bool |
| If a matching job is present a new job will not be added. |
units required |
| The type of units in the future to execute the command or script file. |
Examples
- name: Schedule a command to execute in 20 minutes as root. at: command: ls -d / >/dev/null count: 20 units: minutes - name: Match a command to an existing job and delete the job. at: command: ls -d / >/dev/null state: absent - name: Schedule a command to execute in 20 minutes making sure it is unique in the queue. at: command: ls -d / >/dev/null count: 20 units: minutes unique: yes
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Maintenance
This module is flagged as core which means that it is maintained by the Ansible Core Team. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Core Team, see here.
Support
For more information about Red Hat’s support of this module, please refer to this Knowledge Base article
Author
- Richard Isaacson (@risaacson)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/at_module.html