sysvinit – Управление службами SysV

Новое в версии 2.6.

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

Обзор

Управление службами на целевых хостах, использующих систему инициализации SysV.

Требования

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

Управляемая служба должна иметь соответствующий скрипт инициализации.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
arguments -		Дополнительные аргументы, передаваемые в командной строке и принимаемые некоторыми скриптами инициализации. алиасы: args
daemonize boolean	Варианты: no ← yes	Принудительное выполнение модуля в режиме демона, если служба сама не делает этого должным образом. Это полезно при работе с плохо написанными скриптами инициализации или демонами, что обычно проявляется в зависании задачи, так как она всё ещё держит tty, или в завершении работы службы при завершении задачи, так как соединение закрывает сеанс.
enabled boolean	Варианты: no yes	Указать, должна ли служба запускаться при загрузке. Необходимо указать хотя бы одно из значений state или enabled.
name - / обязательно		Имя службы. алиасы: service
pattern -		Подстрока для поиска в выводе команды ps, как замена результата статуса. Если строка найдена, служба считается работающей. Этот параметр предназначен для использования со скриптами инициализации, которые не поддерживают параметр 'status'.
runlevels -		Уровни выполнения, для которых этот скрипт должен быть включён/выключен. Используйте это для переопределения значений по умолчанию, заданных пакетом или самим скриптом инициализации.
sleep -	По умолчанию: 1	Если служба находится в состоянии `restarted` или `reloaded`, то задержка между командами остановки и запуска составит указанное количество секунд. Это помогает обойти проблемы с плохо работающими службами.
state -	Варианты: started stopped restarted reloaded	`started`/`stopped` — идемпотентные действия, которые не будут запускать команды, если это не необходимо. Не все скрипты инициализации поддерживают `restarted` или `reloaded` напрямую, поэтому оба этих параметра приведут к остановке и запуску при необходимости.

Примечания

Примечание

Необходимо указать хотя бы один параметр помимо name.

Примеры

- name: make sure apache2 is started
  sysvinit:
      name: apache2
      state: started
      enabled: yes

- name: make sure apache2 is started on runlevels 3 and 5
  sysvinit:
      name: apache2
      state: started
      enabled: yes
      runlevels:
        - 3
        - 5

Возвращаемые значения

Общие возвращаемые значения описаны здесь, а следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
results complex	всегда	результаты выполненных действий Пример: {'attempts': 1, 'changed': True, 'name': 'apache2', 'status': {'enabled': {'changed': True, 'rc': 0, 'stderr': '', 'stdout': ''}, 'stopped': {'changed': True, 'rc': 0, 'stderr': '', 'stdout': 'Остановка веб-сервера: apache2.\n'}}}

Статус

Этот модуль не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается командой Ansible Core. [core]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля компанией Red Hat можно найти в этой статье базы знаний Red Hat.

Авторы

Команда Ansible Core

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/sysvinit_module.html