# Triggerer

Triggerer is a small application that triggers execution of scripts when given endpoints are hit
with GET requests. It contains no permissions handling, no authentication, no request limiting. So
these must be handled in some other way, like with an Nginx reverse proxy.

Should work on any \*nix system that has `sh`.

## Installation

1. Clone repo
2. `mix deps.get`
3. Build release with `MIX_ENV=prod COOKIE=yourcookie mix release --env=prod`
4. Run release in your preferred way, setting environment according to the next section

## Environment variables

To bind to a certain port (instead of default `6000`), add env `PORT=1337`.

Configuration of endpoints and scripts is done via environment variables. Environment variables
are set in the following format:

```
TRIGGERER_FOO=/path/to/bar.sh
```

The variable consists of `TRIGGERER_` prefix, after which is the name of the endpoint. The value is
the path to the script to execute. The above variable would result in an endpoint `/foo`, which would
execute `/path/to/bar.sh`.

The endpoint path is transformed to lowercase and underscores are replaced with dashes. See the
following examples:

* `TRIGGERER_FOO` → `/foo`
* `TRIGGERER_CODE_STATS_BETA` → `/code-stats-beta`
* `TRIGGERER_AAA_` → `/aaa-`

The path to the script can be absolute or relative, as long as it can be reached from the current
working dir.

## Return value

If the script was triggered, 200 OK is returned. If the script is not found or the request path is
wrong, 404 File not found is returned. If there is an error in script execution, 500 Internal server
error is returned and the error is logged.