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