ansible-ow-influxdb

Simple ansible role for installing and configuring InfluxDB 1.8.

Designed to be used in OpenWISP installations.

How to run tests

If you want to contribute to ansible-ow-influxdb you should run tests in your development environment to ensure your changes are not breaking anything.

To do that, proceed with the following steps:

Step 1: Clone ansible-ow-influxdb

Clone repository by:

git clone https://github.com/<your_fork>/ansible-ow-influxdb.git

Step 2: Install docker

If you haven't installed docker yet, you need to install it (example for Debian/Ubuntu systems):

sudo apt install docker.io

Step 3: Install molecule and dependencies

pip install molecule[docker] yamllint ansible-lint docker

Step 4: Download docker images

docker pull geerlingguy/docker-ubuntu2404-ansible:latest
docker pull geerlingguy/docker-ubuntu2204-ansible:latest
docker pull geerlingguy/docker-ubuntu2004-ansible:latest
docker pull geerlingguy/docker-debian12-ansible:latest
docker pull geerlingguy/docker-debian11-ansible:latest

Step 5: Run molecule test

molecule test -s local

If you don't get any error message it means that the tests ran successfully without errors.

ProTip: Use molecule test --destroy=never to speed up subsequent test runs.

Role Variables

# By default query logging of InfluxDB is turned off since it can occupy a
# lot of storage. You can turn it on by setting below variable to true.
influxdb_query_logging: true
# The username of the influxdb user that will be created.
influxdb_user_username: admin
# The password of the influxdb user that will be created.
influxdb_user_password: "your-strong-password"
# The hostname or IP address on which InfluxDB server is listening.
influxdb_http_ip: "localhost"
# The port on which InfluxDB server is listening.
influxdb_http_port: 8086
# InfluxDB index version, read InfluxDB's documentation for details
# https://docs.influxdata.com/influxdb/v1.8/administration/config/#index-version--inmem.
# Defaults to "inmem" (InfluxDB's default).
influxdb_index_version: tsi1
# Whether to configure InfluxDB to accept data over UDP.
# Defaults to "false".
influxdb_udp_mode: true
# When "influxdb_udp_mode" is set to "true", the UDP listeners configured
# in this setting are added to the InfluxDB configuration.
# The following is the default value for this setting:
influxdb_udp_settings: |
  # For writing data with the "default" retention policy
  [[udp]]
  enabled = true
  bind-address = "{{ influxdb_http_ip }}:8089"
  database = "openwisp2"
  # For writing data with the "short" retention policy
  [[udp]]
  enabled = true
  bind-address = "{{ influxdb_http_ip }}:8090"
  database = "openwisp2"
  retention-policy = "short"