New in version 2.2.
|daemon_reload ||no|| || |
run daemon-reload before doing any other operations, to make sure systemd has read any changes.
|enabled ||no|| || |
Whether the service should start on boot. At least one of state and enabled are required.
|masked ||no|| || |
Whether the unit should be masked or not, a masked unit is impossible to start.
|name ||no|| |
Name of the service. When using in a chroot environment you always need to specify the full name i.e. (crond.service).
aliases: unit, service
(added in 2.3)
|no|| || |
Do not synchronously wait for the requested operation to finish. Enqueued job will continue without Ansible blocking on its completion.
|state ||no|| || |
|user ||no|| || |
run systemctl talking to the service manager of the calling user, rather than the service manager of the system.
- name: Make sure a service is running systemd: state=started name=httpd - name: stop service cron on debian, if running systemd: name=cron state=stopped - name: restart service cron on centos, in all cases, also issue daemon-reload to pick up config changes systemd: state: restarted daemon_reload: yes name: crond - name: reload service httpd, in all cases systemd: name: httpd state: reloaded - name: enable service httpd and ensure it is not masked systemd: name: httpd enabled: yes masked: no - name: enable a timer for dnf-automatic systemd: name: dnf-automatic.timer state: started enabled: True - name: just force systemd to reread configs (2.4 and above) systemd: daemon_reload=yes
Common return values are documented here Return Values, the following are the fields unique to this module:
A dictionary with the key=value pairs returned from `systemctl show`
This module is flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.
For more information about Red Hat’s this support of this module, please refer to this
knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
© 2012–2017 Michael DeHaan
© 2017 Red Hat, Inc.
Licensed under the GNU General Public License version 3.