systemd – Управление службами
Новая версия 2.2.
Описание
- Управление службами systemd на удаленных хостах.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- Система, управляемая systemd.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| daemon_reexec логическое добавлен в 2.8 |
| Выполнить команду daemon_reexec перед выполнением других операций. Менеджер systemd сериализует состояние менеджера. псевдонимы: daemon-reexec |
| daemon_reload логическое |
| Выполнить daemon-reload перед выполнением других операций, чтобы убедиться, что systemd прочитал все изменения. При значении yes, выполняет daemon-reload, даже если модуль ничего не запускает или не останавливает.псевдонимы: daemon-reload |
| enabled логическое |
| Указывает, должна ли служба запускаться при загрузке. Требуется хотя бы одно из значений state и enabled.
|
| force логическое добавлен в 2.6 |
| Переопределить существующие ссылки. |
| masked логическое |
| Указывает, должна ли единица быть замаскирована. Замаскированная единица не может быть запущена. |
| name - | Имя службы. При использовании в среде chroot всегда необходимо указывать полное имя, например (crond.service). псевдонимы: service, unit | |
| no_block логическое добавлен в 2.3 |
| Не ждать синхронно завершения запрошенной операции. Запущенная задача продолжит выполняться без блокировки Ansible на её завершении. |
| scope - добавлен в 2.7 |
| Выполнить systemctl в указанной области менеджера служб, либо по умолчанию для системы (system), текущего пользователя (user), или для всех пользователей (global). Для работы systemd с 'user', выполняющий пользователь должен иметь свой экземпляр dbus (требование systemd). Процесс dbus пользователя обычно запускается при обычном входе, но не во время выполнения задач Ansible. В противном случае, вероятно, получите ошибку 'Failed to connect to bus: no such file or directory'. |
| state - |
| started/stopped — идемпотентные действия, которые не будут запускать команды, если это не необходимо. restarted всегда перезапустит службу. reloaded всегда перезагрузит. |
| user логическое |
| (устаревшее) Запустить ``systemctl``, обращаясь к менеджеру служб вызывающего пользователя, а не менеджеру служб системы. Этот параметр устарел и в конечном итоге будет удален в 2.11. Вместо него следует использовать параметр ``scope``. |
Примечания
Примечание
- С версии 2.4 требуется один из следующих параметров: ‘state’, ‘enabled’, ‘masked’, ‘daemon_reload’, (‘daemon_reexec’ с версии 2.8), и все, кроме ‘daemon_reload’ (и ‘daemon_reexec’ с версии 2.8), также требуют ‘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
- name: just force systemd to re-execute itself (2.8 and above)
systemd:
daemon_reexec: yes
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| status сложное | success | Словарь с парами ключ-значение, возвращаемыми из `systemctl show` Пример: {'ActiveEnterTimestamp': 'Вс 2016-05-15 18:28:49 EDT', 'ActiveEnterTimestampMonotonic': '8135942', 'ActiveExitTimestampMonotonic': '0', 'ActiveState': 'активно', 'After': 'auditd.service systemd-user-sessions.service time-sync.target systemd-journald.socket basic.target system.slice', 'AllowIsolate': 'нет', 'Before': 'shutdown.target multi-user.target', 'BlockIOAccounting': 'нет', 'BlockIOWeight': '1000', 'CPUAccounting': 'нет', 'CPUSchedulingPolicy': '0', 'CPUSchedulingPriority': '0', 'CPUSchedulingResetOnFork': 'нет', 'CPUShares': '1024', 'CanIsolate': 'нет', 'CanReload': 'да', 'CanStart': 'да', 'CanStop': 'да', 'CapabilityBoundingSet': '18446744073709551615', 'ConditionResult': 'да', 'ConditionTimestamp': 'Вс 2016-05-15 18:28:49 EDT', 'ConditionTimestampMonotonic': '7902742', 'Conflicts': 'shutdown.target', 'ControlGroup': '/system.slice/crond.service', 'ControlPID': '0', 'DefaultDependencies': 'да', 'Delegate': 'нет', 'Description': 'Планировщик команд', 'DevicePolicy': 'авто', 'EnvironmentFile': '/etc/sysconfig/crond (ignore_errors=no)', 'ExecMainCode': '0', 'ExecMainExitTimestampMonotonic': '0', 'ExecMainPID': '595', 'ExecMainStartTimestamp': 'Вс 2016-05-15 18:28:49 EDT', 'ExecMainStartTimestampMonotonic': '8134990', 'ExecMainStatus': '0', 'ExecReload': '{ path=/bin/kill ; argv[]=/bin/kill -HUP $MAINPID ; ignore_errors=no ; start_time=[n/a] ; stop_time=[n/a] ; pid=0 ; code=(null) ; status=0/0 }', 'ExecStart': '{ path=/usr/sbin/crond ; argv[]=/usr/sbin/crond -n $CRONDARGS ; ignore_errors=no ; start_time=[n/a] ; stop_time=[n/a] ; pid=0 ; code=(null) ; status=0/0 }', 'FragmentPath': '/usr/lib/systemd/system/crond.service', 'GuessMainPID': 'да', 'IOScheduling': '0', 'Id': 'crond.service', 'IgnoreOnIsolate': 'нет', 'IgnoreOnSnapshot': 'нет', 'IgnoreSIGPIPE': 'да', 'InactiveEnterTimestampMonotonic': '0', 'InactiveExitTimestamp': 'Вс 2016-05-15 18:28:49 EDT', 'InactiveExitTimestampMonotonic': '8135942', 'JobTimeoutUSec': '0', 'KillMode': 'process', 'KillSignal': '15', 'LimitAS': '18446744073709551615', 'LimitCORE': '18446744073709551615', 'LimitCPU': '18446744073709551615', 'LimitDATA': '18446744073709551615', 'LimitFSIZE': '18446744073709551615', 'LimitLOCKS': '18446744073709551615', 'LimitMEMLOCK': '65536', 'LimitMSGQUEUE': '819200', 'LimitNICE': '0', 'LimitNOFILE': '4096', 'LimitNPROC': '3902', 'LimitRSS': '18446744073709551615', 'LimitRTPRIO': '0', 'LimitRTTIME': '18446744073709551615', 'LimitSIGPENDING': '3902', 'LimitSTACK': '18446744073709551615', 'LoadState': 'загружен', 'MainPID': '595', 'MemoryAccounting': 'нет', 'MemoryLimit': '18446744073709551615', 'MountFlags': '0', 'Names': 'crond.service', 'NeedDaemonReload': 'нет', 'Nice': '0', 'NoNewPrivileges': 'нет', 'NonBlocking': 'нет', 'NotifyAccess': 'none', 'OOMScoreAdjust': '0', 'OnFailureIsolate': 'нет', 'PermissionsStartOnly': 'нет', 'PrivateNetwork': 'нет', 'PrivateTmp': 'нет', 'RefuseManualStart': 'нет', 'RefuseManualStop': 'нет', 'RemainAfterExit': 'нет', 'Requires': 'basic.target', 'Restart': 'нет', 'RestartUSec': '100мс', 'Result': 'успешно', 'RootDirectoryStartOnly': 'нет', 'SameProcessGroup': 'нет', 'SecureBits': '0', 'SendSIGHUP': 'нет', 'SendSIGKILL': 'да', 'Slice': 'system.slice', 'StandardError': 'унаследовать', 'StandardInput': 'null', 'StandardOutput': 'журнал', 'StartLimitAction': 'none', 'StartLimitBurst': '5', 'StartLimitInterval': '10000000', 'StatusErrno': '0', 'StopWhenUnneeded': 'нет', 'SubState': 'запущен', 'SyslogLevelPrefix': 'да', 'SyslogPriority': '30', 'TTYReset': 'нет', 'TTYVHangup': 'нет', 'TTYVTDisallocate': 'нет', 'TimeoutStartUSec': '1мин 30с', 'TimeoutStopUSec': '1мин 30с', 'TimerSlackNSec': '50000', 'Transient': 'нет', 'Type': 'простой', 'UMask': '0022', 'UnitFileState': 'enabled', 'WantedBy': 'multi-user.target', 'Wants': 'system.slice', 'WatchdogTimestampMonotonic': '0', 'WatchdogUSec': '0'} |
Статус
- Этот модуль гарантированно не будет содержать изменений интерфейса, не совместимых со старыми версиями. [stableinterface]
- Этот модуль поддерживается командой разработчиков Ansible. [core]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля компанией Red Hat можно найти в этой статье базы знаний Red Hat.
Авторы
- Команда разработчиков Ansible
Подсказка
Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/systemd_module.html