service – Управление службами
Обзор
- Управляет службами на удаленных хостах. Поддерживаемые системы инициализации включают BSD init, OpenRC, SysV, Solaris SMF, systemd, upstart.
- Для целей Windows используйте модуль win_service вместо этого.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| arguments - | Дополнительные аргументы, предоставленные в командной строке алиасы: args | |
| enabled boolean |
| Указывает, должна ли служба запускаться при загрузке. Требуется хотя бы одно из значений 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', если не найдено совпадения. |
Примечания
Примечание
- Для целей 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.7/modules/service_module.html
