# ansible-role-semaphore

Installs Ansible Semaphore from GitHub releases as a `.deb` package on
Debian-based distributions. A systemd service is created but left stopped
by default: Semaphore requires a `config.json` before it can start.

The service user and group must be created beforehand.

## Requirements

- Ansible >= 2.14
- Debian or Ubuntu

## Role Variables

| Variable | Default | Description |
|---|---|---|
| `semaphore_version` | `""` | Version to install (empty = latest) |
| `semaphore_user` | `semaphore` | User to run Semaphore |
| `semaphore_group` | `semaphore` | Group to run Semaphore |
| `semaphore_install_dir` | `/usr/local/bin` | Binary location after .deb install |
| `semaphore_config_dir` | `/etc/semaphore` | Directory for `config.json` |
| `semaphore_data_dir` | `/var/lib/semaphore` | Working/project directory |
| `semaphore_service_enabled` | `false` | Enable service at boot |
| `semaphore_service_state` | `stopped` | Service state (needs config first) |

## Example Playbook

```yaml
- hosts: automation_servers
  roles:
    - role: ansible-role-semaphore
```

## License

MIT