service_facts – Return service state information as fact data¶
New in version 2.5.
Requirements¶
The below requirements are needed on the host that executes this module.
- Any of the following supported init systems: systemd, sysv, upstart
Notes¶
Note
- When accessing the
ansible_facts.services
facts collected by this module, it is recommended to not use “dot notation” because services can have a-
character in their name which would result in invalid “dot notation”, such asansible_facts.services.zuul-gateway
. It is instead recommended to using the string value of the service name as the key in order to obtain the fact data value likeansible_facts.services['zuul-gateway']
Returned Facts¶
Facts returned by this module are added/updated in the hostvars
host facts and can be referenced by name just like any other host fact. They do not need to be registered in order to use them.
Status¶
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors¶
- Adam Miller (@maxamillion)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.