An Ansible role to install, configure, and manage InfluxDB (a time-series database) v0.9 instances.
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 ones being:
# Channel of InfluxDB to install (stable, unstable, nightly)
influxdb_install_version: stable
# If multiple servers are specified, whether to create a clustered configuration
# NOTE:
# - Do not attempt to cluster previously-unclustered servers. This can lead to data loss.
# - This will overwrite your /etc/default/influxdb file (though it makes a backup)
influxdb_cluster_servers: no
# When clustering is enabled, whether or not to overwrite the /etc/hosts file with raw
# IPs (may be useful if no DNS resolution).
influxdb_overwrite_hosts_file: yes
More advanced configuration options are stored in the defaults/main.yml
file, which includes all of the necessary bells and whistles to tweak your configuration. The entire InfluxDB configuration defaults are set using the defaults/main.yml
file. You may override these via inventory vars, playbook vars, or extra vars.
No other Ansible dependencies are required. This role was tested and developed with Ansible 1.9.4.
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.
Any contributions are welcome. For any bugs or feature requests, please open an issue through Github.
MIT
Created by Ross McDonald.