feat: initial installation role for semaphore

README.md

@@ -0,0 +1,37 @@
+# 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