systemd - Управление службами
Новая версия 2.2.
Описание
- Управляет службами systemd на удаленных хостах.
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- Система, управляемая systemd.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| daemon_reload |
| выполнить daemon-reload перед другими операциями, чтобы убедиться, что systemd прочитал все изменения. псевдонимы: daemon-reload |
| enabled |
| Указывает, должна ли служба запускаться при загрузке. Требуется хотя бы одно из значений state или enabled.
|
| 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: True
- name: just force systemd to reread configs (2.4 and above)
systemd: daemon_reload=yes
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| status сложный | success | Словарь с парами ключ=значение, возвращёнными из `systemctl show` | |
| ExecStart | | ||
| ConditionResult | | ||
| TimeoutStopUSec | | ||
| ControlGroup | | ||
| MainPID | | ||
| GuessMainPID | | ||
| ExecMainCode | | ||
| InactiveExitTimestamp | | ||
| FragmentPath | | ||
| UnitFileState | | ||
| ExecMainPID | | ||
| LimitSIGPENDING | | ||
| WatchdogUSec | | ||
| ActiveState | | ||
| Nice | | ||
| OOMScoreAdjust | | ||
| LoadState | | ||
| DefaultDependencies | | ||
| StatusErrno | | ||
| RootDirectoryStartOnly | | ||
| WantedBy | | ||
| TTYVTDisallocate | | ||
| RestartUSec | | ||
| Transient | | ||
| CPUAccounting | | ||
| CPUSchedulingPolicy | | ||
| StartLimitInterval | | ||
| WatchdogTimestampMonotonic | | ||
| LimitSTACK | | ||
| Restart | | ||
| RemainAfterExit | | ||
| LimitNOFILE | | ||
| CanReload | | ||
| LimitLOCKS | | ||
| AllowIsolate | | ||
| IgnoreOnSnapshot | | ||
| CanIsolate | | ||
| ActiveEnterTimestampMonotonic | | ||
| NeedDaemonReload | | ||
| TTYVHangup | | ||
| EnvironmentFile | | ||
| StandardInput | | ||
| CPUSchedulingPriority | | ||
| KillSignal | | ||
| LimitFSIZE | | ||
| IgnoreOnIsolate | | ||
| Requires | | ||
| LimitCPU | | ||
| ActiveEnterTimestamp | | ||
| ExecMainStatus | | ||
| PermissionsStartOnly | | ||
| LimitDATA | | ||
| MemoryLimit | | ||
| StopWhenUnneeded | | ||
| LimitMSGQUEUE | | ||
| OnFailureIsolate | | ||
| CanStart | | ||
| PrivateTmp | | ||
| Before | | ||
| IOScheduling | | ||
| LimitAS | | ||
| Slice | | ||
| ExecMainExitTimestampMonotonic | | ||
| LimitRTTIME | | ||
| InactiveExitTimestampMonotonic | | ||
| NotifyAccess | | ||
| SendSIGHUP | | ||
| BlockIOAccounting | | ||
| PrivateNetwork | | ||
| MemoryAccounting | | ||
| CanStop | | ||
| NoNewPrivileges | | ||
| ExecMainStartTimestampMonotonic | | ||
| Type | | ||
| SyslogPriority | | ||
| SameProcessGroup | | ||
| SubState | | ||
| TimeoutStartUSec | | ||
| StartLimitBurst | | ||
| LimitNPROC | | ||
| After | | ||
| UMask | | ||
| NonBlocking | | ||
| DevicePolicy | | ||
| RefuseManualStop | | ||
| ExecMainStartTimestamp | | ||
| StartLimitAction | | ||
| Conflicts | | ||
| ConditionTimestamp | | ||
| CapabilityBoundingSet | | ||
| TTYReset | | ||
| Names | | ||
| Желания | | ||
| СтандартныйВывод | | ||
| ФлагиМонтирования | | ||
| ОтклонитьРучнойЗапуск | | ||
| МаркерВремениНеактивногоВходаМонотонный | | ||
| РежимУничтожения | | ||
| ПрефиксУровняСистемногоЖурнала | | ||
| ОграничитьRSS | | ||
| СтандартнаяОшибка | | ||
| ОтправитьSIGKILL | | ||
| ОграничитьRTPRIO | | ||
| ПропуститьSIGPIPE | | ||
| Делегировать | | ||
| ЗагрузитьПерекомпоновку | | ||
| БезопасныеБиты | | ||
| Описание | | ||
| ОграничитьCORE | | ||
| МаркерВремениАктивногоВыходаМонотонный | | ||
| ВремяОжиданияЗадачиUSec | | ||
| ЗадержкаТаймераNSec | | ||
| ОграничитьNICE | | ||
| ВесБлокированияВводаВывода | | ||
| СбросПланированияПроцессораПриВилке | | ||
| Результат | | ||
| ДолиПроцессора | | ||
| УправляющийPID | | ||
| Идентификатор | | ||
| МаркерВремениУсловийМонотонный | | ||
| ОграничитьMEMLOCK | |
Статус
Этот модуль помечен как stableinterface, что означает, что авторы этого модуля гарантируют, что не будет внесено никаких несовместимых изменений интерфейса.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией 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.5/modules/systemd_module.html
