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

Примечание

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

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

Описание
Параметры
Примечания
См. также
Примеры

Описание

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

Примечание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
arguments строка		Дополнительные аргументы, передаваемые в командной строке. При использовании удалённых хостов с systemd это значение будет проигнорировано. псевдонимы: args
enabled логический	Варианты: нет да	Указывает, должна ли служба запускаться при загрузке. Необходимо указать хотя бы одно из state и enabled.
name строка / обязательно		Имя службы.
pattern строка добавлено в 0.7 версии ansible.builtin		Если служба не отвечает на команду status, укажите подстроку для поиска, как она отображается в выводе команды ps, как заменитель результата статуса. Если строка найдена, предполагается, что служба запущена. При использовании удалённых хостов с systemd это значение будет проигнорировано.
runlevel строка	По умолчанию: "default"	Только для скриптов инициализации OpenRC (например, Gentoo). Уровень выполнения, к которому принадлежит эта служба. При использовании удалённых хостов с systemd это значение будет проигнорировано.
sleep целое число добавлено в 1.3 версии ansible.builtin		Если служба `restarted`, то выдерживайте указанное количество секунд между командами остановки и запуска. Это помогает обойти плохо работающие скрипты инициализации, которые выходят немедленно после сигнализации процессу об остановке. Не все менеджеры служб поддерживают sleep, т.е. при использовании systemd это значение будет проигнорировано.
state строка	Варианты: перезагружено перезапущено запущено остановлено	`started`/`stopped` являются идемпотентными действиями, которые не будут запускать команды, если это не необходимо. `restarted` всегда перезапустит службу. `reloaded` всегда перезагрузит. Необходимо указать хотя бы одно из state и enabled. Обратите внимание, что перезагрузка запустит службу, если она ещё не запущена, даже если ваша выбранная система инициализации обычно этого не делает.
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
Michael DeHaan

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