service - Управление службами

Обзор
Параметры
Примечания
Примеры
Статус
- Поддержка
- Автор

Обзор

Управляет службами на удалённых хостах. Поддерживаемые системы инициализации включают BSD init, OpenRC, SysV, Solaris SMF, systemd, upstart.
Для целевых систем Windows используйте модуль win_service.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
arguments		Дополнительные аргументы, заданные в командной строке псевдонимы: args
enabled	Варианты: no yes	Указывает, должна ли служба запускаться при загрузке. Требуется хотя бы одно из значений state или enabled.
name обязательно		Имя службы.
pattern		Если служба не отвечает на команду status, укажите подстроку для поиска, как в выводе команды ps, в качестве замены результата статуса. Если строка найдена, служба считается работающей.
runlevel	По умолчанию: default	Только для скриптов инициализации OpenRC (например, Gentoo). Уровень выполнения, к которому относится данная служба.
sleep (добавлено в 1.3)		Если служба `restarted` , то приостанавливается на столько секунд между командами остановки и запуска. Это помогает обойти плохо работающие скрипты инициализации, которые выходят сразу после сигнализации процессу об остановке.
state	Варианты: reloaded restarted running started stopped	`started`/`stopped` — это идемпотентные действия, которые не будут выполнять команды, если это не нужно. `restarted` всегда перезапускает службу. `reloaded` всегда перезагружает. Требуется хотя бы одно из значений state или enabled. Обратите внимание, что reloaded запустит службу, если она ещё не запущена, даже если ваша выбранная система инициализации обычно этого не делает.
use (добавлено в 2.2)	По умолчанию: auto	Модуль службы на самом деле использует специфичные для системы модули, обычно через автоматическое определение, это значение может принудительно выбрать конкретный модуль. Обычно используется значение факта «ansible_service_mgr» и переходит к старому модулю «service», когда не найдено подходящего.

Примечания

Примечание

Для целевых систем Windows используйте модуль win_service.

Примеры

- name: Start service httpd, if not running
  service:
    name: httpd
    state: started

- name: Stop service httpd, if running
  service:
    name: httpd
    state: stopped

- name: Restart service httpd, in all cases
  service:
    name: httpd
    state: restarted

- name: Reload service httpd, in all cases
  service:
    name: httpd
    state: reloaded

- name: Enable service httpd, and not touch the running state
  service:
    name: httpd
    enabled: yes

- name: Start service foo, based on running process /usr/bin/foo
  service:
    name: foo
    pattern: /usr/bin/foo
    state: started

- name: Restart network service for interface eth0
  service:
    name: network
    state: restarted
    args: eth0

Статус

Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будет вноситься обратной совместимости.

Поддержка

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

Автор

Команда Ansible Core
Michael DeHaan

Подсказка

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

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