ansible.builtin.service_facts (v2.15.2) — module

Install Ansible via pip

Install with pip install ansible-core==2.15.2

Description

Return service state information as fact data for various service management utilities.

Requirements

• Any of the following supported init systems: systemd, sysv, upstart, openrc, AIX SRC

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Populate service facts
  ansible.builtin.service_facts:

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Print service facts
  ansible.builtin.debug:
    var: ansible_facts.services

Outputs

ansible_facts:
  contains:
    services:
      contains:
        name:
          description: Name of the service.
          returned: always
          sample: arp-ethers.service
          type: str
        source:
          description:
          - Init system of the service.
          - One of C(rcctl), C(systemd), C(sysv), C(upstart), C(src).
          returned: always
          sample: sysv
          type: str
        state:
          description:
          - State of the service.
          - 'This commonly includes (but is not limited to) the following: C(failed),
            C(running), C(stopped) or C(unknown).'
          - Depending on the used init system additional states might be returned.
          returned: always
          sample: running
          type: str
        status:
          description:
          - State of the service.
          - Either C(enabled), C(disabled), C(static), C(indirect) or C(unknown).
          returned: systemd systems or RedHat/SUSE flavored sysvinit/upstart or OpenBSD
          sample: enabled
          type: str
      description: States of the services with service name as key.
      returned: always
      type: complex
  description: Facts to add to ansible_facts about the services on the system
  returned: always
  type: complex