Spec-Zone.ru › Ansible 2.5

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

Spec-Zone.ru

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