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 целое число		Если служба `restarted` , то подождите указанное количество секунд между командами stop и start. Это помогает обойти плохо работающие скрипты инициализации, которые выходят сразу после сигнализации процессу о завершении. Не все менеджеры служб поддерживают sleep, например, при использовании systemd данная настройка будет проигнорирована.
state строка	Варианты: reloaded restarted started stopped	`started`/`stopped` - идемпотентные действия, которые не будут выполнять команды, если это не необходимо. `restarted` всегда перезапустит службу. `reloaded` всегда перезагрузит. Требуется хотя бы один из параметров state или enabled. Обратите внимание, что reloaded запустит службу, если она ещё не запущена, даже если выбранная система инициализации обычно этого не делает.
use строка	По умолчанию: "auto"	Модуль службы на самом деле использует модули, специфичные для системы, обычно через автоматическое определение, данная настройка может принудительно задать конкретный модуль. Обычно он использует значение факта 'ansible_service_mgr' и возвращается к старому модулю 'service', если не найдено соответствующего.

Примечания

Примечание

Для AIX можно использовать имена подсистем групп.

См. также

win_service – Управление и запрос служб Windows: Официальная документация по модулю win_service.

Примеры

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

- name: Stop service httpd, if started
  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 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]
Этот модуль поддерживается основной командой Ansible. [core]

Поддержка Red Hat

Дополнительная информация о поддержке данного модуля компанией Red Hat доступна в этой статье базы знаний 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.9/modules/service_module.html