community.general.runit module – Manage runit services
Note
This module is part of the community.general collection (version 8.6.4).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.runit
.
Synopsis
Controls runit services on remote hosts using the sv utility.
Aliases: system.runit
Parameters
Parameter |
Comments |
---|---|
Whether the service is enabled or not, if disabled it also implies stopped. Choices:
|
|
Name of the service to manage. |
|
directory runsv watches for services Default: |
|
directory where services are defined, the source of symlinks to service_dir. Default: |
|
Choices:
|
Attributes
Attribute |
Support |
Description |
---|---|---|
Support: full |
Can run in |
|
Support: none |
Will return details on what has changed (or possibly needs changing in |
Examples
- name: Start sv dnscache, if not running
community.general.runit:
name: dnscache
state: started
- name: Stop sv dnscache, if running
community.general.runit:
name: dnscache
state: stopped
- name: Kill sv dnscache, in all cases
community.general.runit:
name: dnscache
state: killed
- name: Restart sv dnscache, in all cases
community.general.runit:
name: dnscache
state: restarted
- name: Reload sv dnscache, in all cases
community.general.runit:
name: dnscache
state: reloaded
- name: Use alternative sv directory location
community.general.runit:
name: dnscache
state: reloaded
service_dir: /run/service