Files
ansible-role-semaphore/README.md

38 lines
1.1 KiB
Markdown

# 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