systemd — Управление службами
Новая в версии 2.2.
Синопсис
- Управляет службами systemd на удалённых хостах.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- Система, управляемая systemd.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| daemon_reload логическое значение |
| выполнить daemon-reload перед выполнением других операций, чтобы убедиться, что systemd прочитал все изменения. псевдонимы: daemon-reload |
| enabled логическое значение |
| Нужно ли запускать службу при загрузке. Требуется хотя бы одно из значений state или enabled.
|
| force логическое значение (добавлено в 2.6) |
| Переопределять ли существующие символические ссылки. |
| masked логическое значение |
| Нужно ли маскировать единицу, замаскированная единица не может быть запущена. |
| name | Имя службы. При использовании в среде chroot всегда необходимо указывать полное имя, например (crond.service). псевдонимы: service, unit | |
| no_block логическое значение (добавлено в 2.3) |
| Не ждать синхронно завершения запрошенной операции. Запущенная задача будет продолжена без ожидания Ansible её завершения. |
| state |
| started/stopped — идемпотентные действия, которые не будут запускать команды, если это не необходимо. restarted всегда перезапустит службу. reloaded всегда перезагрузит. |
| user логическое значение |
| выполнить systemctl, обращаясь к диспетчеру служб текущего пользователя, а не к диспетчеру служб системы. |
Примечания
Примечание
- Начиная с версии 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 сложный | success | Словарь с парами ключ=значение, возвращёнными из `systemctl show` | |
| ActiveEnterTimestamp | | ||
| ActiveEnterTimestampMonotonic | | ||
| ActiveExitTimestampMonotonic | | ||
| ActiveState | | ||
| After | | ||
| AllowIsolate | | ||
| Before | | ||
| BlockIOAccounting | | ||
| BlockIOWeight | | ||
| CPUAccounting | | ||
| CPUSchedulingPolicy | | ||
| CPUSchedulingPriority | | ||
| CPUSchedulingResetOnFork | | ||
| CPUShares | | ||
| CanIsolate | | ||
| CanReload | | ||
| CanStart | | ||
| CanStop | | ||
| CapabilityBoundingSet | | ||
| ConditionResult | | ||
| ConditionTimestamp | | ||
| ConditionTimestampMonotonic | | ||
| Conflicts | | ||
| ControlGroup | | ||
| ControlPID | | ||
| DefaultDependencies | | ||
| Delegate | | ||
| Description | | ||
| DevicePolicy | | ||
| EnvironmentFile | | ||
| ExecMainCode | | ||
| ExecMainExitTimestampMonotonic | | ||
| ExecMainPID | | ||
| ExecMainStartTimestamp | | ||
| ExecMainStartTimestampMonotonic | | ||
| ExecMainStatus | | ||
| ExecReload | | ||
| ExecStart | | ||
| FragmentPath | | ||
| GuessMainPID | | ||
| IOScheduling | | ||
| Id | | ||
| IgnoreOnIsolate | | ||
| IgnoreOnSnapshot | | ||
| IgnoreSIGPIPE | | ||
| InactiveEnterTimestampMonotonic | | ||
| InactiveExitTimestamp | | ||
| InactiveExitTimestampMonotonic | | ||
| JobTimeoutUSec | | ||
| KillMode | | ||
| KillSignal | | ||
| LimitAS | | ||
| LimitCORE | | ||
| LimitCPU | | ||
| LimitDATA | | ||
| LimitFSIZE | | ||
| LimitLOCKS | | ||
| LimitMEMLOCK | | ||
| LimitMSGQUEUE | | ||
| LimitNICE | | ||
| LimitNOFILE | | ||
| LimitNPROC | | ||
| LimitRSS | | ||
| LimitRTPRIO | | ||
| LimitRTTIME | | ||
| LimitSIGPENDING | | ||
| LimitSTACK | | ||
| LoadState | | ||
| MainPID | | ||
| MemoryAccounting | | ||
| MemoryLimit | | ||
| MountFlags | | ||
| Names | | ||
| NeedDaemonReload | | ||
| Nice | | ||
| NoNewPrivileges | | ||
| NonBlocking | | ||
| NotifyAccess | | ||
| OOMScoreAdjust | | ||
| OnFailureIsolate | | ||
| PermissionsStartOnly | | ||
| PrivateNetwork | | ||
| PrivateTmp | | ||
| RefuseManualStart | | ||
| RefuseManualStop | | ||
| RemainAfterExit | | ||
| Requires | | ||
| Restart | | ||
| RestartUSec | | ||
| Result | | ||
| RootDirectoryStartOnly | | ||
| SameProcessGroup | | ||
| SecureBits | | ||
| SendSIGHUP | | ||
| SendSIGKILL | | ||
| Slice | | ||
| StandardError | | ||
| StandardInput | | ||
| StandardOutput | | ||
| StartLimitAction | | ||
| StartLimitBurst | | ||
| StartLimitInterval | | ||
| StatusErrno | | ||
| StopWhenUnneeded | | ||
| SubState | | ||
| SyslogLevelPrefix | | ||
| SyslogPriority | | ||
| TTYReset | | ||
| TTYVHangup | | ||
| TTYVTDisallocate | | ||
| TimeoutStartUSec | | ||
| TimeoutStopUSec | | ||
| TimerSlackNSec | | ||
| Transient | | ||
| Type | | ||
| UMask | | ||
| UnitFileState | | ||
| WantedBy | | ||
| Wants | | ||
| WatchdogTimestampMonotonic | | ||
| WatchdogUSec | |
Статус
Этот модуль помечен как stableinterface, что означает, что авторы этого модуля гарантируют, что не будет вноситься обратной совместимости.
Техническое обслуживание
Этот модуль помечен как core, что означает, что он поддерживается командой Ansible Core. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых командой Ansible Core, см. здесь.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией 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.6/modules/systemd_module.html
