nosh - Управление службами с помощью nosh
Новая версия 2.5.
Обзор
- Управление запуском и включенным состоянием системных или пользовательских служб.
- Поддерживаются системы BSD и Linux.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- Система с активным менеджером служб nosh. См. раздел «Примечания» для получения дополнительной информации.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| enabled bool |
| Включить или отключить службу независимо от предпочтений файла *.preset или состояния выполнения. Взаимоисключающее с параметром preset. Применится до state=reset. |
| name обязательно | Имя управляемой службы. | |
| preset bool |
| Включить или отключить службу в соответствии с локальными предпочтениями в файлах *.preset. Взаимоисключающее с параметром enabled. Действует только при значении «да». Применится до state=reset. |
| state |
| started/stopped — идемпотентные действия, которые не будут запускать команды, если это не необходимо. restarted всегда перезапускает службу. reloaded отправит SIGHUP или запустит службу. reset запустит или остановит службу в зависимости от того, включена ли она. |
| user bool |
| Выполнить системное управление, взаимодействуя с менеджером служб вызывающего пользователя, а не с системным менеджером служб. |
Примечания
Примечание
- Информация о наборе утилит nosh доступна по адресу https://jdebp.eu/Softwares/nosh/.
Примеры
- name: start dnscache if not running
nosh: name=dnscache state=started
- name: stop mpd, if running
nosh: name=mpd state=stopped
- name: restart unbound or start it if not already running
nosh:
name: unbound
state: restarted
- name: reload fail2ban or start it if not already running
nosh:
name: fail2ban
state: reloaded
- name: disable nsd
nosh: name=nsd enabled=no
- name: for package installers, set nginx running state according to local enable settings, preset and reset
nosh: name=nginx preset=True state=reset
- name: reboot the host if nosh is the system manager, would need a "wait_for*" task at least, not recommended as-is
nosh: name=reboot state=started
- name: using conditionals with the module facts
tasks:
- name: obtain information on tinydns service
nosh: name=tinydns
register: result
- name: fail if service not loaded
fail: msg="The {{ result.name }} service is not loaded"
when: not result.status
- name: fail if service is running
fail: msg="The {{ result.name }} service is running"
when: result.status and result.status['DaemontoolsEncoreState'] == "running"
Значения возврата
Общие значения возврата описаны здесь. Ниже приведены поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| enabled boolean | успех | включена ли служба при загрузке системы Пример: True | |
| name строка | успех | имя, используемое для поиска службы Пример: sshd | |
| preset boolean | успех | отражает ли состояние включения состояние, установленное в соответствующем файле *.preset | |
| service_path строка | успех | решенный путь к службе Пример: /var/sv/sshd | |
| state строка | если используется параметр state | состояние процесса службы, None, если служба не загружена и не будет запущенаПример: перезагружен | |
| status сложное | успех | словарь с парами ключ-значение, возвращаемыми `system-control show-json`, или None, если служба не загружена | |
| После | | ||
| До | | ||
| Конфликты | | ||
| DaemontoolsEncoreState | | ||
| DaemontoolsState | | ||
| Включено | | ||
| LogService | | ||
| MainPID | | ||
| Приостановлено | | ||
| ReadyAfterRun | | ||
| RemainAfterExit | | ||
| Required-By | | ||
| RestartExitStatusCode | | ||
| RestartExitStatusNumber | | ||
| RestartTimestamp | | ||
| RestartUTCTimestamp | | ||
| RunExitStatusCode | | ||
| RunExitStatusNumber | | ||
| RunTimestamp | | ||
| RunUTCTimestamp | | ||
| StartExitStatusCode | | ||
| StartExitStatusNumber | | ||
| StartTimestamp | | ||
| StartUTCTimestamp | | ||
| StopExitStatusCode | | ||
| StopExitStatusNumber | | ||
| StopTimestamp | | ||
| StopUTCTimestamp | | ||
| Stopped-By | | ||
| Timestamp | | ||
| UTCTimestamp | | ||
| Want | | ||
| Wanted-By | | ||
| Wants | | ||
| user boolean | успех | используется ли пользовательский менеджер служб | |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.
Автор
- Thomas Caravia
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/nosh_module.html