ansible.builtin.service_facts – Возвращение информации о состоянии службы в виде фактических данных
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев, вы можете использовать сокращённое имя модуля service_facts даже без указания ключевого слова collections:. Несмотря на это, мы рекомендуем использовать полное имя класса (FQCN) для лёгкой ссылки на документацию модуля и для избежания конфликтов с другими коллекциями, которые могут иметь такое же имя модуля.
Новый в версии 2.5: от ansible.builtin
Описание
- Возвращает информацию о состоянии службы в виде фактических данных для различных утилит управления службами.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- Любая из поддерживаемых систем инициализации: systemd, sysv, upstart
Примечания
Примечание
- При доступе к фактам
ansible_facts.services, собранным этим модулем, рекомендуется не использовать «точечную нотацию», так как у служб может быть символ-в имени, что приведёт к некорректной «точечной нотации», например,ansible_facts.services.zuul-gateway. Вместо этого рекомендуется использовать строковое значение имени службы в качестве ключа для получения значения фактических данных, какansible_facts.services['zuul-gateway'] - Поддерживает
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. Пример: sysv | |
| state string / elements=string | всегда | Состояние службы. Либо running, stopped, или unknown. Пример: running | |
| status string / elements=string | системы systemd или RedHat/SUSE flavored sysvinit/upstart | Состояние службы. Либо enabled, disabled, static, indirect или unknown. Пример: enabled | |
Авторы
- Adam Miller (@maxamillion)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/builtin/service_facts_module.html