nosh — Управление службами с помощью nosh
Новое в версии 2.5.
Обзор
- Управление запуском и включенным состоянием системных или пользовательских служб.
- Поддерживаются системы BSD и Linux.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Система с активным менеджером служб nosh. Дополнительную информацию см. в разделе «Примечания».
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| enabled |
| Включить или отключить службу независимо от предпочтений файла *.preset или состояния выполнения. Взаимоисключительно с preset. Будет применено до state=reset. |
| name обязательно | Имя управляемой службы. | |
| preset |
| Включить или отключить службу в соответствии с локальными предпочтениями в файлах *.preset. Взаимоисключительно с enabled. Имеет эффект только при значении «да». Будет применено до state=reset. |
| state |
| started/stopped — идемпотентные действия, которые не будут запускать команды, если это не необходимо. restarted всегда перезапустит службу. reloaded отправит SIGHUP или запустит службу. reset запустит или остановит службу в зависимости от того, включена ли она. |
| user |
| Выполнить системное управление, обращаясь к менеджеру служб вызывающего пользователя, а не к системному менеджеру служб. |
Примечания
Примечание
- Информация о наборе утилит 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 булево | успешно | указывает, включена ли служба при запуске системы Пример: True | |
| name строка | успешно | имя, используемое для поиска службы Пример: sshd | |
| preset булево | успешно | указывает, соответствует ли состояние включения состоянию, заданному в соответствующем файле *.preset | |
| service_path строка | успешно | рассчитанный путь к службе Пример: /var/sv/sshd | |
| state строка | если используется параметр state | состояние процесса службы, None если служба не загружена и не будет запущенаПример: перезагружена | |
| status сложный | успешно | словарь с парами ключ-значение, возвращаемыми `system-control show-json`, или None если служба не загружена | |
| StopTimestamp | | ||
| RunUTCTimestamp | | ||
| MainPID | | ||
| Wanted-By | | ||
| Wants | | ||
| UTCTimestamp | | ||
| LogService | | ||
| StartTimestamp | | ||
| After | | ||
| StopExitStatusCode | | ||
| DaemontoolsState | | ||
| StopUTCTimestamp | | ||
| RemainAfterExit | | ||
| Stopped-By | | ||
| Conflicts | | ||
| RunExitStatusNumber | | ||
| RunTimestamp | | ||
| RestartExitStatusCode | | ||
| DaemontoolsEncoreState | | ||
| StartUTCTimestamp | | ||
| Enabled | | ||
| RestartExitStatusNumber | | ||
| RestartTimestamp | | ||
| StartExitStatusNumber | | ||
| StartExitStatusCode | | ||
| RestartUTCTimestamp | | ||
| StopExitStatusNumber | | ||
| Paused | | ||
| ReadyAfterRun | | ||
| Want | | ||
| Timestamp | | ||
| Required-By | | ||
| RunExitStatusCode | | ||
| Before | | ||
| user булево | успешно | указывает, вызывается ли менеджер служб на уровне пользователя | |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Автор
- 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.5/modules/nosh_module.html