Spec-Zone.ru › Ansible 2.6

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API