Spec-Zone.ru › Ansible 2.10

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
  • restarted
  • reloaded
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API