community.general.launchd – Управление службами macOS

Примечание

Этот плагин входит в состав коллекции community.general (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.launchd.

Новое в версии 1.0.0: из community.general

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управление службами launchd на целевых хостах macOS.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

Система, управляемая launchd
Библиотека plistlib языка Python

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
enabled логический тип	Варианты: no yes	Указывает, должна ли служба запускаться при загрузке. Требуется хотя бы один из параметров state и enabled.
force_stop логический тип	Варианты: no ← yes	Указывает, не должна ли служба перезапускаться автоматически launchd. Службы могут иметь атрибут 'KeepAlive' со значением true в конфигурации launchd. В случае, если этот атрибут установлен в значение true, остановка службы приведет к тому, что launchd запустит её снова. Установите этот параметр в `yes`, чтобы позволить этому модулю изменить атрибут 'KeepAlive' на false.
name строка / обязательный		Имя службы.
state строка	Варианты: reloaded restarted started stopped unloaded	`started`/`stopped` — идемпотентные действия, которые не будут выполнять команды, если это не необходимо. Launchd не поддерживает `restarted` и `reloaded` напрямую. Эти значения приведут к остановке/запуску (restarted) или выгрузке/загрузке (reloaded). `restarted` выгружает и загружает службу перед запуском, чтобы убедиться, что используется последняя конфигурация задания (plist). `reloaded` выгружает и загружает службу, чтобы убедиться, что используется последняя конфигурация задания (plist). Запуск или остановка службы зависит от содержимого файла определения.

Примечания

Примечание

Пользователь должен иметь соответствующие привилегии для управления службами с помощью этого модуля.

Примеры

- name: Make sure spotify webhelper is started
  community.general.launchd:
    name: com.spotify.webhelper
    state: started

- name: Deploy custom memcached job definition
  template:
    src: org.memcached.plist.j2
    dest: /Library/LaunchDaemons/org.memcached.plist

- name: Run memcached
  community.general.launchd:
    name: org.memcached
    state: started

- name: Stop memcached
  community.general.launchd:
    name: org.memcached
    state: stopped

- name: Stop memcached
  community.general.launchd:
    name: org.memcached
    state: stopped
    force_stop: yes

- name: Restart memcached
  community.general.launchd:
    name: org.memcached
    state: restarted

- name: Unload memcached
  community.general.launchd:
    name: org.memcached
    state: unloaded

Возвращаемые значения

Общие возвращаемые значения описаны в этом разделе, ниже приведены поля, уникальные для данного модуля:

Ключ	Возвращаемое значение	Описание
status словарь	всегда	Метаданные о статусе службы Пример: {'current_pid': '-', 'current_state': 'stopped', 'previous_pid': '82636', 'previous_state': 'running'}

Авторы

Martin Migasiewicz (@martinm82)

© 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/community/general/launchd_module.html