Spec-Zone.ru › Ansible 2.8

nosh – Управление службами с помощью nosh

Новая версия 2.5.

  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Значения возврата
  • Статус

Описание

  • Управление состоянием запуска и включения системных или пользовательских служб.
  • Поддерживаются системы BSD и Linux.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • Система с активным менеджером служб nosh, см. раздел «Примечания» для получения дополнительной информации.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
enabled
boolean
    Варианты:
  • no
  • yes
Включить или отключить службу независимо от предпочтений файла *.preset или состояния выполнения. Взаимоисключительно с параметром preset. Будет применено до state=reset.
name
- / обязательно
Имя службы для управления.
preset
boolean
    Варианты:
  • no
  • yes
Включить или отключить службу в соответствии с локальными настройками в файлах *.preset. Взаимоисключительно с параметром enabled. Действует только при установке в значение true. Будет применено до state=reset.
state
-
    Варианты:
  • started
  • stopped
  • reset
  • restarted
  • reloaded
started/stopped — идемпотентные действия, которые не будут запускать команды, если это не необходимо. restarted всегда перезапустит службу. reloaded отправит SIGHUP или запустит службу. reset запустит или остановит службу в зависимости от того, включена она или нет.
user
boolean
    Варианты:
  • no ←
  • yes
Выполнять системный контроль, взаимодействуя с менеджером служб вызывающего пользователя, а не с системным менеджером служб.

Примечания

Примечание

  • Информация о наборе утилит 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

Spec-Zone.ru

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