ansible.builtin.sysvinit – Управление службами SysV.
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля sysvinit даже без указания ключевого слова collections:. Несмотря на это, мы рекомендуем использовать FQCN для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же самое имя модуля.
Новый в версии 2.6: от ansible.builtin
Обзор
- Управляет службами на целевых узлах, использующих систему инициализации SysV.
Требования
Ниже перечислены требования, необходимые на узле, выполняющем этот модуль.
- Служба, которой управляет модуль, должна иметь соответствующий скрипт init.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| arguments строка | Дополнительные аргументы, передаваемые в командной строке, которые некоторые скрипты init принимают. псевдонимы: args | |
| daemonize булево |
| Запустить модуль в режиме демона, так как сама служба может этого не делать должным образом. Это полезно с плохо написанными скриптами init или демонами, что часто проявляется в зависании задачи, так как она всё ещё держит tty, или в завершении работы службы при завершении задачи, так как подключение закрывает сеанс. |
| enabled булево |
| Запускать ли службу при загрузке. Необходимо указать как минимум один из параметров state и enabled.
|
| name строка / обязательный | Имя службы. псевдонимы: service | |
| pattern строка | Подстрока для поиска, как она может быть найдена в выводе команды ps в качестве замены результата статуса. Если строка найдена, предполагается, что служба запущена. Этот параметр предназначен в основном для использования со скриптами init, которые не поддерживают опцию 'status'. | |
| runlevels строка | Уровни работы, с которых этот скрипт должен быть включён/выключен. Используйте это для переопределения значений по умолчанию, установленных пакетом или самим скриптом init. | |
| sleep строка | Значение по умолчанию: 1 | Если служба останавливается или запускается, подождите указанное количество секунд между командами stop и start. Это помогает обойти проблемы с плохо работающими службами. |
| state строка |
| started/stopped — идемпотентные действия, которые не будут выполнять команды, если это не необходимо. Не все скрипты init поддерживают restarted и reloaded напрямую, поэтому оба варианта приведут к остановке и последующему запуску по мере необходимости. |
Примечания
Примечание
- Необходимо указать хотя бы один параметр помимо name.
Примеры
- name: Make sure apache2 is started
sysvinit:
name: apache2
state: started
enabled: yes
- name: Make sure apache2 is started on runlevels 3 and 5
sysvinit:
name: apache2
state: started
enabled: yes
runlevels:
- 3
- 5
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| results сложный | всегда | результаты выполненных действий Пример: {'attempts': 1, 'changed': True, 'name': 'apache2', 'status': {'enabled': {'changed': True, 'rc': 0, 'stderr': '', 'stdout': ''}, 'stopped': {'changed': True, 'rc': 0, 'stderr': '', 'stdout': 'Остановка веб-сервера: apache2.\n'}}} |
Авторы
- Команда разработчиков 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.10/collections/ansible/builtin/sysvinit_module.html