Additional arguments provided on the command line
Whether the service should start on boot. At least one of state and enabled are required.
Name of the service.
If the service does not respond to the status command, name a substring to look for as would be found in the output of the ps command as a stand-in for a status result. If the string is found, the service will be assumed to be running.
For OpenRC init scripts (ex: Gentoo) only. The runlevel that this service belongs to.
(added in 1.3)
If the service is being
(added in 2.2)
The service module actually uses system specific modules, normally through auto detection, this setting can force a specific module.
Normally it uses the value of the 'ansible_service_mgr' fact and falls back to the old 'service' module when none matching is found.
# Example action to start service httpd, if not running - service: name: httpd state: started # Example action to stop service httpd, if running - service: name: httpd state: stopped # Example action to restart service httpd, in all cases - service: name: httpd state: restarted # Example action to reload service httpd, in all cases - service: name: httpd state: reloaded # Example action to enable service httpd, and not touch the running state - service: name: httpd enabled: yes # Example action to start service foo, based on running process /usr/bin/foo - service: name: foo pattern: /usr/bin/foo state: started # Example action to restart network service for interface eth0 - service: name: network state: restarted args: eth0
This module is flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.