# Ansible Role: Semaphore

Install and configure [Semaphore UI](https://semaphoreui.com/) - a modern UI for Ansible.

## Variables

| Variable                    | Required | Default                 | Description                 |
| --------------------------- | -------- | ----------------------- | --------------------------- |
| `mitogen_version`           | No       | `0.3.45`                | Mitogen version to install  |
| `semaphore_admin_username`  | No       | `admin`                 | Admin username              |
| `semaphore_admin_password`  | Yes      | `admin`                 | Admin password              |
| `semaphore_admin_name`      | No       | `Administrator`         | Admin display name          |
| `semaphore_admin_email`     | No       | `admin@example.com`     | Admin email                 |
| `semaphore_runner_token`    | Yes      | `runner-token`          | Runner authentication token |
| `semaphore_email_sender`    | No       | `semaphore@example.com` | Email sender address        |
| `semaphore_email_host`      | No       | `smtp`                  | SMTP host                   |
| `semaphore_email_port`      | No       | `465`                   | SMTP port                   |
| `semaphore_email_username`  | No       | `smtp-user`             | SMTP username               |
| `semaphore_email_password`  | Yes      | `smtp-pass`             | SMTP password               |
| `semaphore_ansible_ssh_key` | Yes      | ----------------------- | Ansible SSH private key     |
| `semaphore_ssh_config`      | No       | ----------------------- | SSH config content          |

## Example

```yaml
mitogen_version: "0.3.45"
semaphore_admin_username: "admin"
semaphore_admin_password: "secure_password"
semaphore_admin_email: "admin@example.com"
semaphore_runner_token: "secure-runner-token"
semaphore_email_host: "smtp.example.com"
semaphore_email_password: "smtp_password"
semaphore_ansible_ssh_key: "{{ vault_ansible_ssh_key }}"
```