ansible-role-grafana/README.md

# laurivan.grafana

This role installs Grafana via Docker.

## Requirements

None

## Role Variables

All variables are listed below (see also `defaults/main.yml`).

### Paths and Volumes

All paths are by default defined as relative to `grafana_volume_base`:

```yml
grafana_volume_base: "/mnt/data/grafana"
grafana_setup_path: "{{ grafana_volume_base }}/config"
grafana_volume_grafana: "{{ grafana_volume_base }}/grafana"
grafana_volume_influxdb: "{{ grafana_volume_base }}/influxdb"
```

You can however define specific volumes for the individual items:

- `grafana_setup_path` - where the Docker compose files are placed
- `grafana_volume_grafana` - volume for the grafana docker container
- `grafana_volume_influxdb` - volume for InfluxDB

### InfluxDB

We define the following variables for InfluxDB:

```yml
influxdb:
  username: influxdb
  password: change_me
  org: example.com
  bucket: my_bucket
  admin_token: change_me
```

### Grafana

We also define several variables for grafana

```yml
grafana:
  username: changeme
  password: changeme
```

Just in case, you can override the user/group for grafana via:

```yml
grafana_uid:
grafana_gid:
```

## Dependencies

You need a machine with docker and docker-compose installed.

## Example Playbook

```yml
- hosts: servers
  roles:
      - 'laurivan.grafana'
```

## License

MIT

## Author Information

This role was created in 2022 by [Laur Ivan](https://www.laurivan.com).