Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zenoamaro/ansible-grafana

An Ansible role for deploying and configuring Grafana on unix hosts.
https://github.com/zenoamaro/ansible-grafana

Last synced: about 2 months ago
JSON representation

An Ansible role for deploying and configuring Grafana on unix hosts.

Awesome Lists containing this project

README

        

Grafana for Ansible
======================
A role for deploying and configuring [Grafana](http://grafana.com) on unix hosts using [Ansible](http://www.ansibleworks.com).

It can additionally be used as a playbook for quickly provisioning hosts.

Vagrant machines are provided to produce a boxed install of Grafana or a VM for integration testing.

Supports
--------
Supported Grafana versions:
- Grafana ^1.9.1

Supported targets:
- Ubuntu 14.04 LTS "Trusty Tahr"
- Ubuntu 12.04 LTS "Precise Pangolin"
- Debian (untested)
- RedHat (untested)

Installation methods:
- Official repository from [Grafana](https://github.com/grafana/grafana)

Usage
-----
Clone this repo into your roles directory:

$ git clone https://github.com/zenoamaro/ansible-grafana.git roles/grafana

And add it to your play's roles:

- hosts: ...
roles:
- grafana
- ...

This roles comes preloaded with almost every available default. You can override each one in your hosts/group vars, in your inventory, or in your play. See the annotated defaults in [defaults/main.yml](defaults/main.yml) for help in configuration. All provided variables start with `grafana_`.

You can also use the role as a playbook. You will be asked which hosts to provision, and you can further configure the play by using `--extra-vars`.

$ ansible-playbook -i inventory --extra-vars='{...}' main.yml

To provision a standalone box, start the `boxed` VM, which is a Ubuntu 14.04 box. After that, you can login to the admin interface on the host (on `18083` by default) as user `root` and password `root`. You will similarly find the API available (on `18086` by default) with the same credentials.

$ vagrant up boxed

Run the tests by provisioning the appropriate VM:

$ vagrant up test-ubuntu-trusty

At the moment, the following test boxes are available:

- `test-ubuntu-precise`
- `test-ubuntu-trusty`

Changelog
---------
### 0.1.0
Initial version.