ansible-role-grafana/README.md
2022-12-19 15:02:42 +01:00

79 lines
1.4 KiB
Markdown

# 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).