systemd — Управление службами.
Новая версия 2.2.
- Краткое описание
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Значения возврата
- Примечания
Краткое описание
- Управляет службами systemd на удалённых хостах.
Требования (к хосту, на котором выполняется модуль)
- Система, управляемая systemd
Параметры
| параметр | обязателен | по умолчанию | возможные значения | комментарии |
|---|---|---|---|---|
| daemon_reload | нет |
| выполнить daemon-reload перед любыми другими операциями, чтобы убедиться, что systemd прочитал все изменения. псевдонимы: daemon-reload | |
| enabled | нет |
| Должна ли служба запускаться при загрузке. Требуется хотя бы одно из значений state и enabled.
| |
| masked | нет |
| Должен ли блок быть замаскированным или нет; замаскированный блок невозможно запустить. | |
| name | нет | Имя службы. При использовании в среде chroot всегда необходимо указывать полное имя, например (crond.service). псевдонимы: unit, service | ||
| no_block (добавлено в 2.3)
| нет |
| Не ждать синхронно завершения запрошенной операции. Запланированная задача будет продолжена без блокировки Ansible на её завершении. | |
| state | нет |
| started/stopped — идемпотентные действия, которые не будут запускать команды, если это не нужно. restarted всегда перезапускает службу. reloaded всегда перезагружает. | |
| user | нет |
| Запустить systemctl, взаимодействуя с менеджером служб вызывающего пользователя, а не менеджером служб системы. |
Примеры
- 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 | Словарь с парами ключ=значение, возвращёнными из `systemctl show` | успех | сложный |
| содержит: |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Примечания
Примечание
- Начиная с версии 2.4, требуется один из следующих параметров: «состояние», «включено», «замаскировано», «daemon_reload», и все, кроме «daemon_reload», также требуют «имя».
- До версии 2.4 всегда требовалось «имя».
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будут вноситься несовместимые с предыдущими версиями изменения интерфейса.
Информация о техническом обслуживании
Для получения дополнительной информации о поддержке этого модуля компанией Red Hat, пожалуйста, обратитесь к этому knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Для получения помощи в разработке модулей, если вас это интересует, пожалуйста, прочитайте Информацию о сообществе и вклад, Тестирование 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.4/systemd_module.html
