Spec-Zone.ru › Ansible 2.8

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

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

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

Описание

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

Требования

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

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
daemon_reexec
логическое
добавлен в 2.8
    Варианты:
  • no ←
  • yes
Выполнить команду daemon_reexec перед выполнением других операций. Менеджер systemd сериализует состояние менеджера.

псевдонимы: daemon-reexec
daemon_reload
логическое
    Варианты:
  • no ←
  • yes
Выполнить daemon-reload перед выполнением других операций, чтобы убедиться, что systemd прочитал все изменения.
При значении yes, выполняет daemon-reload, даже если модуль ничего не запускает или не останавливает.

псевдонимы: 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_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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API