ansible.builtin.service_facts – Возвращение информации о состоянии службы в виде фактов
Примечание
Этот модуль является частью ansible-base и включен во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля service_facts даже без указания ключевого слова collections:. Несмотря на это, мы рекомендуем использовать FQCN для удобной ссылки на документацию по модулю и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Новое в версии 2.5: из ansible.builtin
Обзор
- Возвращение информации о состоянии службы в виде фактов для различных утилит управления службами.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- Любая из следующих поддерживаемых систем инициализации: systemd, sysv, upstart, AIX SRC
Примечания
Примечание
- При обращении к фактам
ansible_facts.services, собранным этим модулем, рекомендуется не использовать «точечную нотацию», так как у служб может быть символ-в их имени, что приведет к некорректной «точечной нотации», такой какansible_facts.services.zuul-gateway. Вместо этого рекомендуется использовать строковое значение имени службы в качестве ключа для получения значения факта, например,ansible_facts.services['zuul-gateway'] - AIX SRC был добавлен в версии 2.11.
- Поддерживает
check_mode.
Примеры
- name: Populate service facts
ansible.builtin.service_facts:
- name: Print service facts
ansible.builtin.debug:
var: ansible_facts.services
Возвращаемые факты
Возвращаемые этим модулем факты добавляются/обновляются в фактах хоста hostvars и могут быть обработаны по имени, как и любой другой факт хоста. Их не нужно регистрировать для использования.
| Факт | Возвращается | Описание | |
|---|---|---|---|
| services complex / elements=string | всегда | Состояния служб с именем службы в качестве ключа. | |
| name string / elements=string | всегда | Имя службы. Пример: arp-ethers.service | |
| source string / elements=string | всегда | Система инициализации службы. Один из systemd, sysv, upstart, src. Пример: sysv | |
| state string / elements=string | всегда | Состояние службы. Либо running, stopped, либо unknown. Пример: running | |
| status string / elements=string | системы systemd или RedHat/SUSE sysvinit/upstart | Состояние службы. Либо enabled, disabled, static, indirect или unknown. Пример: enabled | |
Авторы
- Adam Miller (@maxamillion)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/service_facts_module.html