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

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

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

Чтобы использовать его в книге задач, укажите: community.general.launchd.

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

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

Описание

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

Требования

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

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
enabled boolean	Варианты: no yes	Указывает, следует ли запускать службу при загрузке. Требуется хотя бы одно из значений state или enabled.
force_stop boolean	Варианты: no ← yes	Указывает, следует ли не перезапускать службу автоматически launchd. Службы могут иметь атрибут 'KeepAlive', установленный в значение true в конфигурации launchd. В случае его установки остановка службы приведет к тому, что launchd запустит службу снова. Установите это значение в `yes` чтобы позволить этому модулю изменить атрибут 'KeepAlive' на false.
name string / обязательно		Имя службы.
state string	Варианты: 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 dictionary	всегда	Метаданные о состоянии службы Пример: {'current_pid': '-', 'current_state': 'stopped', 'previous_pid': '82636', 'previous_state': 'running'}

Авторы

Martin Migasiewicz (@martinm82)

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