An Ansible role to install, configure, and manage InfluxDB (a time-series database).
Prior knowledge/experience with InfluxDB is highly recommended. Full documentation is available here.
Either clone this repository, or install through Ansible Galaxy directly using the command:
ansible-galaxy install rossmcdonald.influxdb
The high-level variables are stored in the defaults/main.yml file. The most important one being:
# Channel of InfluxDB to install (stable, unstable, nightly)
influxdb_install_version: stable
More advanced configuration options are also stored in the
defaults/main.yml file, which includes all of the necessary bells
and whistles to tweak your configuration. There are more advanced
runtime options available in the vars/main.yml file as well.
No other Ansible dependencies are required. This role was tested and developed with Ansible 1.9.4.
To test the role locally, it is recommended to either use
Vagrant or Docker. There are a variety
of available Dockerfiles in the /docker directory. For more
information on building the images, please review the
docker/build.sh script.
To run a playbook within one of the Docker images, simply run:
docker run -v $(pwd):/root <DOCKER IMAGE> <PLAYBOOK>
For example, to run the included test.yml using the included CentOS
7 Docker image, run (after building the image):
docker run -v $(pwd):/root ansible.influxdb.centos7 test.yml
An example playbook is included in the test.yml file. There is also
a Vagrantfile, which can be used for quick local testing leveraging
Vagrant, and a few Docker Dockerfiles
located in the /docker directory.
Any contributions are welcome. For any bugs or feature requests, please open an issue through Github.
MIT
Created by Ross McDonald.