ansible.builtin.sysvinit – Управление службами SysV.
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев можно использовать короткое имя модуля sysvinit даже без указания ключевого слова collections:. Несмотря на это, мы рекомендуем использовать FQCN для удобной ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
В версии 2.6: из ansible.builtin
Обзор
- Управляет службами на целевых хостах, использующих систему инициализации SysV.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- Управляемая служба должна иметь соответствующий скрипт инициализации.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| arguments строка | Дополнительные аргументы, предоставляемые в командной строке, которые принимают некоторые скрипты инициализации. алиасы: args | |
| daemonize булево |
| Заставить модуль работать как демон, так как сама служба может не делать этого должным образом. Это полезно для плохо написанных скриптов инициализации или демонов, что обычно проявляется в зависании задачи, так как она всё ещё удерживает tty, или служба умирает при завершении задачи, так как подключение закрывает сеанс. |
| enabled булево |
| Указывает, должна ли служба запускаться при загрузке. Требуется по крайней мере одно из значений state и enabled.
|
| name строка / обязательно | Имя службы. алиасы: service | |
| pattern строка | Подстрока для поиска, как она может быть найдена в выводе команды ps в качестве замены результата состояния. Если строка найдена, предполагается, что служба работает. Этот параметр предназначен в основном для использования со скриптами инициализации, которые не поддерживают опцию «status». | |
| runlevels список / элементы=строка | Уровни выполнения, в которых должен быть включен/выключен этот скрипт. Используйте это для переопределения значений по умолчанию, установленных пакетом или самим скриптом инициализации. | |
| sleep целое число | По умолчанию: 1 | Если служба restarted или reloaded, то следует подождать столько секунд между командами остановки и запуска. Это помогает обойти проблемы с плохо работающими службами. |
| state строка |
| started/stopped — это идемпотентные действия, которые не будут запускать команды, если это не нужно. Не все скрипты инициализации поддерживают 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/sysvinit_module.html