nosh – Управление службами с помощью nosh
Новая версия 2.5.
Описание
- Управление состоянием запуска и включения системных или пользовательских служб.
- Поддерживаются системы BSD и Linux.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- Система с активным менеджером служб nosh, см. раздел «Примечания» для получения дополнительной информации.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| enabled boolean |
| Включить или отключить службу независимо от предпочтений файла *.preset или состояния выполнения. Взаимоисключительно с параметром preset. Будет применено до state=reset. |
| name - / обязательно | Имя службы для управления. | |
| preset boolean |
| Включить или отключить службу в соответствии с локальными настройками в файлах *.preset. Взаимоисключительно с параметром enabled. Действует только при установке в значение true. Будет применено до state=reset. |
| state - |
| started/stopped — идемпотентные действия, которые не будут запускать команды, если это не необходимо. restarted всегда перезапустит службу. reloaded отправит SIGHUP или запустит службу. reset запустит или остановит службу в зависимости от того, включена она или нет. |
| user boolean |
| Выполнять системный контроль, взаимодействуя с менеджером служб вызывающего пользователя, а не с системным менеджером служб. |
Примечания
Примечание
- Информация о наборе утилит 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 если сервис не загружен и не будет запущенПример: reloaded | |
| status сложный | успех | словарь с парами ключ=значение, возвращаемыми командой `system-control show-json`, или None если сервис не загружен | |
| After - | | ||
| Before - | | ||
| Conflicts - | | ||
| DaemontoolsEncoreState - | | ||
| DaemontoolsState - | | ||
| Enabled - | | ||
| LogService - | | ||
| MainPID - | | ||
| Paused - | | ||
| ReadyAfterRun - | | ||
| RemainAfterExit - | | ||
| Required-By - | | ||
| RestartExitStatusCode - | | ||
| RestartExitStatusNumber - | | ||
| RestartTimestamp - | | ||
| RestartUTCTimestamp - | | ||
| RunExitStatusCode - | | ||
| RunExitStatusNumber - | | ||
| RunTimestamp - | | ||
| RunUTCTimestamp - | | ||
| StartExitStatusCode - | | ||
| StartExitStatusNumber - | | ||
| StartTimestamp - | | ||
| StartUTCTimestamp - | | ||
| StopExitStatusCode - | | ||
| StopExitStatusNumber - | | ||
| Stopped-By - | | ||
| StopTimestamp - | | ||
| StopUTCTimestamp - | | ||
| Timestamp - | | ||
| UTCTimestamp - | | ||
| Want - | | ||
| Wanted-By - | | ||
| Wants - | | ||
| user boolean | успех | вызывается ли менеджер сервиса на уровне пользователя | |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Thomas Caravia (@tacatac)
Подсказка
Если вы обнаружите проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/nosh_module.html