https://github.com/devture/com.devture.ansible.role.systemd_service_manager

An Ansible role which manages systemd services
https://github.com/devture/com.devture.ansible.role.systemd_service_manager

Last synced: 13 days ago
JSON representation

An Ansible role which manages systemd services

• Host: GitHub
• URL: https://github.com/devture/com.devture.ansible.role.systemd_service_manager
• Owner: devture
• Created: 2022-11-23T07:59:13.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-17T09:51:32.000Z (10 months ago)
• Last Synced: 2024-01-17T17:28:08.354Z (10 months ago)
• Language: Makefile
• Size: 14.6 KB
• Stars: 1
• Watchers: 2
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# systemd service manager Ansible role

This is an [Ansible](https://www.ansible.com/) role which manages systemd services.

## Features

- **starting** (restarting) services, in order, according to their `priority`. Services can all be stopped cleanly and then started anew, or they can be restarted one-by-one (see `devture_systemd_service_manager_service_restart_mode`)

- making services **auto-start** (see `devture_systemd_service_manager_services_autostart_enabled`)

- **verifying** services managed to start (see `devture_systemd_service_manager_up_verification_enabled`)

- **stopping** services, in order, according to their `priority`

- starting/stopping all defined services, or a group of services (`--tags=restart-group`, `--tags=stop-group`)

- restarting services by cleanly stopping them and restarting them, or one by one

## Usage

Example playbook:

```yaml

- hosts: servers

  roles:

    - when: devture_systemd_service_manager_enabled | bool

      role: galaxy/com.devture.ansible.role.systemd_service_manager

```

Example playbook configuration (`group_vars/servers` or other):

```yaml

# See `devture_systemd_service_manager_services_list_auto` and `devture_systemd_service_manager_services_list_additional`

devture_systemd_service_manager_services_list_auto: |

  {{

    ([{'name': 'some-service.service', 'priority': 1000}])

    +

    ([{'name': 'another-service.service', 'priority': 1500}])

  }}

```

Example playbook invocations tags (e.g. `ansible-playbook -i inventory/hosts setup.yml --tags=XXXXX`):

- `restart`, `restart-all`, `start-all` - restarts all services and potentially makes them auto-start (depending on `devture_systemd_service_manager_services_autostart_enabled`)

- `restart-group`, `start-group` - restarts services belonging to the specified group (e.g. `--extra-vars="group=core"`)

- `stop`, `stop-all` - stops all services

- `stop-group` - stops services belonging to the specified group (e.g. `--extra-vars="group=core"`)