Simple ansible role for installing and configuring influxdb.
Designed to be used in Immunity installations.
If you want to contribute to ansible-im-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-im-influxdb
Clone repository by:
git clone https://github.com/<your_fork>/ansible-im-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-ubuntu2204-ansible:latest
docker pull geerlingguy/docker-ubuntu2004-ansible:latest
docker pull geerlingguy/docker-ubuntu1804-ansible:latest
docker pull geerlingguy/docker-debian10-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.
# 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 = "immunity22"
# For writing data with the "short" retention policy
[[udp]]
enabled = true
bind-address = "{{ influxdb_http_ip }}:8090"
database = "immunity22"
retention-policy = "short"