service - Управление службами
Обзор
- Управляет службами на удаленных хостах. Поддерживаемые системы инициализации включают BSD init, OpenRC, SysV, Solaris SMF, systemd, upstart.
- Для целевых систем Windows используйте модуль win_service вместо этого.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| arguments | Дополнительные аргументы, переданные в командной строке псевдонимы: args | |
| enabled bool |
| Указывает, должна ли служба запускаться при загрузке. Требуется хотя бы один из параметров state и enabled.
|
| name обязательно | Имя службы. | |
| pattern | Если служба не отвечает на команду status, укажите подстроку для поиска, как это отображается в выводе команды ps, чтобы заменить результат статуса. Если строка найдена, служба будет считаться работающей. | |
| runlevel | Значение по умолчанию: "default" | Только для скриптов инициализации OpenRC (например, Gentoo). Уровень выполнения, к которому принадлежит эта служба. |
| sleep (добавлен в версии 1.3) | Если служба restarted , то подождите столько секунд между командами остановки и запуска. Это помогает обойти плохо работающие скрипты инициализации, которые выходят сразу после отправки сигнала процессу для остановки. | |
| state |
| started/stopped - это идемпотентные действия, которые не будут запускать команды, если это не нужно. restarted всегда перезапустит службу. reloaded всегда перезагрузит. Требуется хотя бы один из параметров state и enabled. Обратите внимание, что перезагрузка запустит службу, если она еще не запущена, даже если выбранная система инициализации обычно этого не делает. |
| 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, что означает, что разработчики этого модуля гарантируют, что не будут вноситься несовместимые изменения интерфейса.
Техническое обслуживание
Этот модуль помечен как core, что означает, что его поддерживает команда Ansible Core. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, поддерживаемых командой Ansible Core Team, см. здесь.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией 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.6/modules/service_module.html
