ansible-role-systemd_service/README.md
XiaojueGuan 0ce596a6e2 Add release note link in README
Change-Id: I9bd1face3d651bfe28028e2c0fa585a14f14c98b
2018-06-29 14:58:07 +08:00

50 lines
1.4 KiB
Markdown

#### Ansible systemd_service
This Ansible role that installs and configures systemd unit files and all of its
corresponding services. This role requires the ``openstack-ansible-plugins``
repository to be available on your local system. The Ansible galaxy resolver
will not retrieve this role for you. To get this role in place clone the
plugins repository **before** installing this role.
``` bash
# git clone https://github.com/openstack/openstack-ansible-plugins /etc/ansible/roles/plugins
```
Release notes for the project can be found at:
https://docs.openstack.org/releasenotes/ansible-role-systemd_service
You can also use the ``ansible-galaxy`` command on the ``ansible-role-requirements.yml`` file.
``` bash
# ansible-galaxy install -r ansible-role-requirements.yml
```
----
###### Example playbook
``` yaml
- name: Create a systemd unit file for ServiceX
hosts: localhost
become: true
roles:
- role: "systemd_service"
systemd_services:
# Normal Service
- service_name: ServiceX
execstarts:
- /path/ServiceX --flag1
# Timer Service (AKA CRON)
- service_name: TimerServiceX
execstarts:
- /path/TimerServiceX --flag1
timer:
state: "started"
options:
OnBootSec: 30min
OnUnitActiveSec: 1h
Persistent: true
tags:
- servicex-init
```