systemd – Управление службами

Новая версия 2.2.

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

Краткое описание

Управляет службами systemd на удалённых хостах.

Требования

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

Система, управляемая systemd.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
daemon_reload логическое	Варианты: no ← yes	выполнить daemon-reload перед любыми другими операциями, чтобы убедиться, что systemd прочитал все изменения. алиасы: daemon-reload
enabled логическое	Варианты: no yes	Указывает, должна ли служба запускаться при загрузке. Требуется хотя бы одно из значений state или enabled.
force логическое добавлен в 2.6	Варианты: no yes	Перезаписывать существующие символические ссылки.
masked логическое	Варианты: no yes	Указать, следует ли замаскировать единицу, замаскированная единица не может быть запущена.
name -		Имя службы. При использовании в среде chroot всегда необходимо указывать полное имя, например (crond.service). алиасы: service, unit
no_block логическое добавлен в 2.3	Варианты: no ← yes	Не ждать синхронно завершения запрошенной операции. Запущенная задача продолжится без блокировки Ansible на ее завершение.
scope - добавлен в 2.7	Варианты: system ← user global	выполнить systemctl в заданном контексте менеджера служб, либо в системном контексте (system), контексте текущего пользователя (user) или контексте всех пользователей (global). Для работы systemd с 'user' выполняющему пользователю необходимо запустить свой экземпляр dbus (требование systemd). Процесс dbus пользователя обычно запускается при обычном входе, но не во время выполнения задач Ansible. В противном случае, вероятно, вы получите ошибку 'Failed to connect to bus: no such file or directory'.
state -	Варианты: reloaded restarted started stopped	`started`/`stopped` — идемпотентные действия, которые не будут запускать команды, если это не нужно. `restarted` всегда перезапускает службу. `reloaded` всегда перезагружает.
user логическое	Варианты: no ← yes	(устарело) выполнить ``systemctl``, обращаясь к менеджеру служб вызывающего пользователя, а не менеджеру служб системы. Этот параметр устарел и в конечном итоге будет удален в версии 2.11. Вместо него следует использовать параметр ``scope``.

Примечания

Примечание

Начиная с версии 2.4, требуется один из следующих параметров: ‘state’, ‘enabled’, ‘masked’, ‘daemon_reload’, а все, кроме ‘daemon_reload’, также требуют ‘name’.
До версии 2.4 всегда требовалось ‘name’.

Примеры

- name: Make sure a service is running
  systemd:
    state: started
    name: httpd

- name: stop service cron on debian, if running
  systemd:
    name: cron
    state: stopped

- name: restart service cron on centos, in all cases, also issue daemon-reload to pick up config changes
  systemd:
    state: restarted
    daemon_reload: yes
    name: crond

- name: reload service httpd, in all cases
  systemd:
    name: httpd
    state: reloaded

- name: enable service httpd and ensure it is not masked
  systemd:
    name: httpd
    enabled: yes
    masked: no

- name: enable a timer for dnf-automatic
  systemd:
    name: dnf-automatic.timer
    state: started
    enabled: yes

- name: just force systemd to reread configs (2.4 and above)
  systemd:
    daemon_reload: yes

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

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

Ключ		Возвращаемое значение	Описание
status complex		success	Словарь с парами ключ=значение, возвращёнными из `systemctl show`
	ActiveEnterTimestamp -
	ActiveEnterTimestampMonotonic -
	ActiveExitTimestampMonotonic -
	ActiveState -
	After -
	AllowIsolate -
	Before -
	BlockIOAccounting -
	BlockIOWeight -
	CanIsolate -
	CanReload -
	CanStart -
	CanStop -
	CapabilityBoundingSet -
	ConditionResult -
	ConditionTimestamp -
	ConditionTimestampMonotonic -
	Conflicts -
	ControlGroup -
	ControlPID -
	CPUAccounting -
	CPUSchedulingPolicy -
	CPUSchedulingPriority -
	CPUSchedulingResetOnFork -
	CPUShares -
	DefaultDependencies -
	Delegate -
	Description -
	DevicePolicy -
	EnvironmentFile -
	ExecMainCode -
	ExecMainExitTimestampMonotonic -
	ExecMainPID -
	ExecMainStartTimestamp -
	ExecMainStartTimestampMonotonic -
	ExecMainStatus -
	ExecReload -
	ExecStart -
	FragmentPath -
	GuessMainPID -
	Id -
	IgnoreOnIsolate -
	IgnoreOnSnapshot -
	IgnoreSIGPIPE -
	InactiveEnterTimestampMonotonic -
	InactiveExitTimestamp -
	InactiveExitTimestampMonotonic -
	IOScheduling -
	JobTimeoutUSec -
	KillMode -
	KillSignal -
	LimitAS -
	LimitCORE -
	LimitCPU -
	LimitDATA -
	LimitFSIZE -
	LimitLOCKS -
	LimitMEMLOCK -
	LimitMSGQUEUE -
	LimitNICE -
	LimitNOFILE -
	LimitNPROC -
	LimitRSS -
	LimitRTPRIO -
	LimitRTTIME -
	LimitSIGPENDING -
	LimitSTACK -

	СостояниеЗагрузки -
	MainPID -
	УчётПамяти -
	ПределПамяти -
	ФлагиМонтирования -
	Имена -
	НужноПерезагрузитьДемона -
	Nice -
	БезБлокировки -
	НетНовыхПривилегий -
	УведомлениеОбДоступе -
	ИзоляцияПриОшибке -
	НастройкаOOMScore -
	ПривилегииТолькоПриЗапуске -
	ЧастнаяСеть -
	ЧастотныйДиск -
	ОтказатьсяОтРучногоЗапуска -
	ОтказатьсяОтРучнойОстановки -
	ОстатьсяПослеВыхода -
	Требует -
	Перезапуск -
	ПерезапускUSec -
	Результат -
	КорневойДискТолькоПриЗапуске -
	ТакойЖеПроцессГруппа -
	БезопасныеБита -
	ОтправитьSIGHUP -
	ОтправитьSIGKILL -
	Срез -
	СтандартнаяОшибка -
	СтандартныйВвод -
	СтандартныйВывод -
	ДействиеОграниченияНачала -
	ВсплескОграниченияНачала -
	ИнтервалОграниченияНачала -
	ОшибкаСтатуса -
	ОстановкаПриНеНужности -
	ПодСостояние -
	ПрефиксЛогераСистемы -
	ПриоритетЛогераСистемы -
	ВремяОстановкиТаймаута -
	ВремяЗапускаТаймаута -
	ЗадержкаТаймера -
	Временный -
	СбросTTY -
	TTYVОтключение -
	TTYVTОсвобождение -
	Тип -
	UMask -
	СостояниеФайлаЕдиницы -
	Требуется -
	Желает -
	МаркерВременныхМетокВознаграждения -
	WatchdogUSec -

Статус

Данный модуль гарантированно не будет содержать обратной несовместимости в будущих обновлениях. [stableinterface]
Этот модуль поддерживается командой Ansible Core. [core]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний Red Hat.

Авторы

Команда 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.7/modules/systemd_module.html