Spec-Zone.ru › Ansible 2.11

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

Spec-Zone.ru

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