Модуль community.general.systemd_info — сбор информации о модулях systemd

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.systemd_info.

Добавлено в community.general 10.4.0

Краткое описание
Параметры
Атрибуты
Примеры
Возвращаемые значения

Краткое описание

Этот модуль собирает сведения о модулях systemd (службах, целях, сокетах, точках монтирования и таймерах).
Поддержка модулей таймеров появилась в community.general 10.5.0.
Он запускает systemctl list-units (или обрабатывает выбранные модули) и собирает свойства каждого модуля с помощью systemctl show.
Если у модуля есть несколько свойств с одинаковым именем, собирается только значение первого из них.
Даже если у модуля units.loadstate имеет значение not-found или masked, он возвращается, но только с минимальным набором свойств (units.name, units.loadstate, units.activestate, units.substate).
При использовании unitname и extra_properties модуль сначала проверяет, существует ли модуль, а затем — существуют ли свойства. Если нет, модуль завершается с ошибкой.
При использовании unitname с шаблонами подстановки модуль проверяет наличие модулей, соответствующих указанным шаблонам. Если для какого-либо из указанных шаблонов модуль не найден, модуль завершается с ошибкой.

Параметры

Параметр	Комментарии
extra_properties list / elements=string	Дополнительные свойства для получения (добавляются к свойствам по умолчанию). Обратите внимание: все имена свойств преобразуются в нижний регистр. По умолчанию: `[]`
unitname list / elements=string	Список имён модулей для обработки. Поддерживаются типы модулей `.service`, `.target`, `.socket`, `.mount` и `.timer`. Поддержка модулей `.timer` появилась в community.general 10.5.0. Каждое имя должно соответствовать полному имени модуля `systemd` или шаблону подстановки, например `'ssh'` и `'.service'`. Поддержка шаблонов подстановки в `unitname` появилась в community.general 10.5.0. По умолчанию: `[]`

Параметр

Комментарии

extra_properties

list / elements=string

Дополнительные свойства для получения (добавляются к свойствам по умолчанию).

Обратите внимание: все имена свойств преобразуются в нижний регистр.

По умолчанию: []

unitname

list / elements=string

Список имён модулей для обработки.

Поддерживаются типы модулей .service, .target, .socket, .mount и .timer.

Поддержка модулей .timer появилась в community.general 10.5.0.

Каждое имя должно соответствовать полному имени модуля systemd или шаблону подстановки, например 'ssh*' и '*.service'.

Поддержка шаблонов подстановки в unitname появилась в community.general 10.5.0.

По умолчанию: []

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная Это действие не изменяет состояние.	Может выполняться в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: не применимо Это действие не изменяет состояние.	В режиме сравнения возвращает сведения об изменениях (или о том, что может потребоваться изменить в `check_mode`).

Примеры

---
# Gather info for all systemd services, targets, sockets, mount and timer
- name: Gather all systemd unit info
  community.general.systemd_info:
  register: results

# Gather info for selected units with extra properties.
- name: Gather info for selected unit(s)
  community.general.systemd_info:
    unitname:
      - systemd-journald.service
      - systemd-journald.socket
      - sshd-keygen.target
      - -.mount
    extra_properties:
      - Description
    register: results

# Gather info using wildcards/expression
- name: Gather info of units that start with 'systemd-'
  community.general.systemd_info:
    unitname:
      - 'systemd-*'
  register: results

# Gather info for systemd-tmpfiles-clean.timer with extra properties
- name: Gather info of systemd-tmpfiles-clean.timer and extra AccuracyUSec
  community.general.systemd_info:
    unitname:
      - systemd-tmpfiles-clean.timer
    extra_properties:
      - AccuracyUSec
  register: results

Возвращаемые значения

Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
units dictionary	Словарь со сведениями о модулях systemd, индексированный по имени модуля. Дополнительные поля возвращаются в зависимости от значения `extra_properties`. Возвращается: при успешном выполнении Пример: {"-.mount": {"activestate": "active", "description": "Root Mount", "loadstate": "loaded", "name": "-.mount", "options": "rw,relatime,seclabel,attr2,inode64,logbufs=8,logbsize=32k,noquota", "substate": "mounted", "type": "xfs", "what": "/dev/mapper/cs-root", "where": "/"}, "sshd-keygen.target": {"activestate": "active", "description": "sshd-keygen.target", "fragmentpath": "/usr/lib/systemd/system/sshd-keygen.target", "loadstate": "loaded", "name": "sshd-keygen.target", "substate": "active", "unitfilepreset": "disabled", "unitfilestate": "static"}, "systemd-journald.service": {"activestate": "active", "description": "Journal Service", "execmainpid": "613", "fragmentpath": "/usr/lib/systemd/system/systemd-journald.service", "loadstate": "loaded", "mainpid": "613", "name": "systemd-journald.service", "substate": "running", "unitfilepreset": "disabled", "unitfilestate": "static"}, "systemd-journald.socket": {"activestate": "active", "description": "Journal Socket", "fragmentpath": "/usr/lib/systemd/system/systemd-journald.socket", "loadstate": "loaded", "name": "systemd-journald.socket", "substate": "running", "unitfilepreset": "disabled", "unitfilestate": "static"}}
activestate string	Текущее активное состояние модуля. Наиболее распространённые значения: `active`, `inactive` и `failed`, но возможны и другие значения. Возвращается: всегда Пример: `"active"`
execmainpid string	PID процесса ExecStart модуля. Возвращается: только для модулей `.service`. Пример: `"799"`
fragmentpath string	Путь к файлу фрагмента модуля. Возвращается: всегда, кроме модулей `.mount`. Пример: `"/usr/lib/systemd/system/systemd-journald.service"`
loadstate string	Состояние загрузки конфигурации модуля. Наиболее распространённые значения: `loaded`, `not-found` и `masked`, но возможны и другие значения. Возвращается: всегда Пример: `"loaded"`
mainpid string	PID основного процесса модуля. Возвращается: только для модулей `.service`. Пример: `"798"`
name string	Полное имя модуля. Возвращается: всегда Пример: `"systemd-journald.service"`
options string	Параметры монтирования. Возвращается: только для модулей `.mount`. Пример: `"rw,relatime,noquota"`
substate string	Подробное под-состояние модуля. Наиболее распространённые значения: `running`, `dead`, `exited`, `failed`, `listening`, `active` и `mounted`, но возможны и другие значения. Возвращается: всегда Пример: `"running"`
type string	Тип файловой системы смонтированного устройства. Возвращается: только для модулей `.mount`. Пример: `"ext4"`
unitfilepreset string	Предустановленное состояние конфигурации файла модуля. Наиболее распространённые значения: `enabled`, `disabled` и `static`, но возможны и другие значения. Возвращается: всегда, кроме модулей `.mount`. Пример: `"disabled"`
unitfilestate string	Фактическое состояние конфигурации файла модуля. Наиболее распространённые значения: `enabled`, `disabled` и `static`, но возможны и другие значения. Возвращается: всегда, кроме модулей `.mount`. Пример: `"enabled"`
what string	Смонтированное устройство. Возвращается: только для модулей `.mount`. Пример: `"/dev/sda1"`
where string	Точка монтирования устройства. Возвращается: только для модулей `.mount`. Пример: `"/"`

Авторы

Marco Noce (@NomakCooper)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/systemd_info_module.html