## Configuration

1. Install Ansible on your machine (`pacman -S ansible`).
2. You should have an account with sudoers rights on the target.
3. Add an host to your `~/.ssh/config` to simplify the login process:

```
Host aperture-labs
	HostName v5.planet-casio.com
	User <username>
```

## Use a role

Usually, it looks like this:

```
# Dummy try with --check
ansible-playbook -i inventory.yml role.yml -v --diff --check --ask-become-pass
# Real try
ansible-playbook -i inventory.yml role.yml -v --ask-become-pass
```

The file `inventory.yml` already contains an host: the main VPS, `aperture-labs`.
See [Configuration](#Configuration) to add the host to your SSH config.

## Existing roles

### Nginx

**Update the nginx configuration, reload the service**

| Variable name    | Mandatory | Comment                                      |
|------------------|-----------|----------------------------------------------|
| sites_enabled    | yes       | List of sites to enable from sites-available |

### Uwsgi

**Update the uwsgi configuration, restart the service**

| Variable name    | Mandatory | Comment                                      |
|------------------|-----------|----------------------------------------------|
| environments     | yes       | List of environments to restart              |