service - Управление службами.
Обзор
- Управляет службами на удаленных хостах. Поддерживаемые системы инициализации включают BSD init, OpenRC, SysV, Solaris SMF, systemd, upstart.
- Для целей Windows используйте модуль win_service вместо этого.
Параметры
| параметр | обязательно | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| arguments | нет | Дополнительные аргументы, предоставленные в командной строке псевдонимы: args | ||
| enabled | нет |
| Указывает, должна ли служба запускаться при загрузке. Требуется хотя бы один из параметров state или enabled.
| |
| name | да | Имя службы. | ||
| pattern | нет | Если служба не отвечает на команду status, укажите подстроку для поиска, которая будет найдена в выводе команды ps в качестве замещающего результата статуса. Если строка найдена, служба предполагается работающей. | ||
| runlevel | нет | default | Только для скриптов инициализации OpenRC (например, Gentoo). Уровень выполнения, к которому относится эта служба. | |
| sleep (добавлен в 1.3)
| нет | Если служба restarted , то задержите выполнение на указанное количество секунд между командами остановки и запуска. Это помогает обойти плохо работающие скрипты инициализации, которые выходят немедленно после сигнализации процессу об остановке. | ||
| state | нет |
| started/stopped — идемпотентные действия, которые не будут запускать команды, если это не необходимо. restarted всегда перезапускает службу. reloaded всегда перезагружает. Требуется хотя бы один из параметров state или enabled. Обратите внимание, что reloaded запустит службу, если она еще не запущена, даже если выбранная система инициализации этого обычно не делает. | |
| use (добавлен в 2.2)
| нет | auto | Модуль службы на самом деле использует специфичные для системы модули, обычно через автоматическое определение. Этот параметр позволяет принудительно использовать определенный модуль. Обычно он использует значение факта 'ansible_service_mgr' и возвращается к старому модулю 'service', если не найден подходящий. |
Примеры
# Example action to start service httpd, if not running
- service:
name: httpd
state: started
# Example action to stop service httpd, if running
- service:
name: httpd
state: stopped
# Example action to restart service httpd, in all cases
- service:
name: httpd
state: restarted
# Example action to reload service httpd, in all cases
- service:
name: httpd
state: reloaded
# Example action to enable service httpd, and not touch the running state
- service:
name: httpd
enabled: yes
# Example action to start service foo, based on running process /usr/bin/foo
- service:
name: foo
pattern: /usr/bin/foo
state: started
# Example action to restart network service for interface eth0
- service:
name: network
state: restarted
args: eth0
Примечания
Примечание
- Для целей Windows используйте модуль win_service вместо этого.
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики гарантируют отсутствие обратной несовместимости в изменениях интерфейса.
Информация о техническом обслуживании
Для получения дополнительной информации о поддержке этого модуля компанией Red Hat, пожалуйста, обратитесь к этому knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Для получения помощи в разработке модулей, если у вас есть такое желание, пожалуйста, прочтите Информацию о сообществе и сотрудничестве, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/service_module.html
