ansible.builtin.service – Управление службами

Примечание

Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля service, даже не указывая ключевое слово collections:. Несмотря на это, мы рекомендуем использовать FQCN для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.

Новое в версии 0.1: от ansible.builtin

Обзор
Параметры
Примечания
См. также
Примеры

Обзор

Управляет службами на удалённых хостах. Поддерживаемые системы инициализации включают BSD init, OpenRC, SysV, Solaris SMF, systemd, upstart.
Для целей Windows используйте модуль ansible.windows.win_service вместо этого.

Примечание

У этого модуля есть соответствующий плагин действий.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
arguments строка		Дополнительные аргументы, предоставляемые в командной строке. При использовании удалённых хостов с systemd это значение будет проигнорировано. псевдонимы: args
enabled логический	Варианты: no yes	Устанавливает, будет ли служба запускаться при загрузке. Требуется хотя бы одно из state и enabled.
name строка / обязательно		Имя службы.
pattern строка добавлено в 0.7 ansible.builtin		Если служба не отвечает на команду статуса, укажите подстроку для поиска, как она может быть найдена в выводе команды ps, как заменитель результата статуса. Если строка найдена, предполагается, что служба запущена. При использовании удалённых хостов с systemd это значение будет проигнорировано.
runlevel строка	Значение по умолчанию: "default"	Только для скриптов инициализации OpenRC (например, Gentoo). Уровень выполнения, к которому принадлежит эта служба. При использовании удалённых хостов с systemd это значение будет проигнорировано.
sleep целое число добавлено в 1.3 ansible.builtin		Если служба `restarted`, то задержка между командами остановки и запуска в секундах. Это помогает обойти плохо себя ведущие скрипты инициализации, которые выходят сразу после сигнализации процессу о остановке. Не все менеджеры служб поддерживают sleep, то есть при использовании systemd это значение будет проигнорировано.
state строка	Варианты: reloaded restarted started stopped	`started`/`stopped` — идемпотентные действия, которые не будут запускать команды, если это не необходимо. `restarted` всегда перезапускает службу. `reloaded` всегда перезагружает. Требуется хотя бы одно из state и enabled. Обратите внимание, что reloaded запустит службу, если она ещё не запущена, даже если ваша выбранная система инициализации обычно этого не делала.
use строка добавлено в 2.2 ansible.builtin	Значение по умолчанию: "auto"	Модуль service фактически использует модули, специфичные для системы, обычно через автоматическое обнаружение, это значение может принудительно установить конкретный модуль. Обычно он использует значение факта 'ansible_service_mgr' и возвращается к старому модулю 'service', если ничего подходящего не найдено.

Примечания

Примечание

Для AIX можно использовать имена подсистем групп.
Поддерживает check_mode.

См. также

ansible.windows.win_service: Официальная документация по модулю ansible.windows.win_service.

Примеры

- name: Start service httpd, if not started
  ansible.builtin.service:
    name: httpd
    state: started

- name: Stop service httpd, if started
  ansible.builtin.service:
    name: httpd
    state: stopped

- name: Restart service httpd, in all cases
  ansible.builtin.service:
    name: httpd
    state: restarted

- name: Reload service httpd, in all cases
  ansible.builtin.service:
    name: httpd
    state: reloaded

- name: Enable service httpd, and not touch the state
  ansible.builtin.service:
    name: httpd
    enabled: yes

- name: Start service foo, based on running process /usr/bin/foo
  ansible.builtin.service:
    name: foo
    pattern: /usr/bin/foo
    state: started

- name: Restart network service for interface eth0
  ansible.builtin.service:
    name: network
    state: restarted
    args: eth0

Авторы

Команда Ansible Core
Майкл ДеХан

© 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/service_module.html