mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
25 lines
1.6 KiB
ReStructuredText
25 lines
1.6 KiB
ReStructuredText
.. _service:
|
|
|
|
service
|
|
```````
|
|
|
|
Controls services on remote machines.
|
|
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
| parameter | required | default | comments |
|
|
+====================+==========+=========+============================================================================+
|
|
| name | yes | | name of the service |
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
| state | no | started | 'started', 'stopped', 'reloaded', or 'restarted'. Started/stopped are |
|
|
| | | | idempotent actions that will not run commands unless neccessary. |
|
|
| | | | 'restarted' will always bounce the service, 'reloaded' will always reload. |
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
| enabled | no | | Whether the service should start on boot. Either 'yes' or 'no'. |
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
|
|
Example action from Ansible :doc:`playbooks`::
|
|
|
|
service name=httpd state=started
|
|
service name=httpd state=stopped
|
|
service name=httpd state=restarted
|
|
service name=httpd state=reloaded
|