Skip to content
Installs and configures the InfluxDB timeseries database
SaltStack JavaScript HTML Ruby Shell Python
Branch: master
Clone or download
Pull request Compare This branch is 110 commits ahead, 2 commits behind seegno:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_modules
bin ci: merge travis matrix, add `salt-lint` & `rubocop` to `lint` job Oct 9, 2019
docs
influxdb
test
.gitignore
.rubocop.yml
.salt-lint
.travis.yml
.yamllint
AUTHORS.md
CHANGELOG.md
Gemfile
LICENSE
commitlint.config.js
kitchen.yml
pillar.example
pre-commit_semantic-release.sh
release-rules.js
release.config.js

README.rst

influxdb-formula

Travis CI Build Status Semantic Release

Formula to set up and configure influxdb.

General notes

See the full SaltStack Formulas installation and usage instructions.

If you are interested in writing or contributing to formulas, please pay attention to the Writing Formula Section.

If you want to use this formula, please pay attention to the FORMULA file and/or git tag, which contains the currently released version. This formula is versioned according to Semantic Versioning.

See Formula Versioning Section for more details.

Contributing to this repo

Commit message formatting is significant!!

Please see How to contribute for more details.

Available states

influxdb

Installs InfluxDB from [provided packages](http://influxdb.com/download/).

At the moment you have to specify the InfluxDB version in the influxdb:version pillar.

influxdb.cli

Installs the [influxdb-cli](https://github.com/phstc/influxdb-cli) gem system wide.

influxdb.config

Renders the InfluxDB configuration from data provided in the influxdb:conf pillar.

It requires the installation of the [toml Python module](https://github.com/hit9/toml.py) via pip.

The formula ships with default configuration settings for various minor versions of InfluxDB. That means that, if you define configuration settings in your influxdb.conf pillar, your settings will be merged with the default ones of that minor version. You can set influxdb:no_conf_defaults in your pillar if you want to completely specify the configuration yourself, without falling back to defaults.

Testing

Linux testing is done with kitchen-salt.

Requirements

  • Ruby
  • Docker
$ gem install bundler
$ bundle install
$ bin/kitchen test [platform]

Where [platform] is the platform name defined in kitchen.yml, e.g. debian-9-2019-2-py3.

bin/kitchen converge

Creates the docker instance and runs the influxdb main state, ready for testing.

bin/kitchen verify

Runs the inspec tests on the actual instance.

bin/kitchen destroy

Removes the docker instance.

bin/kitchen test

Runs all of the stages above in one go: i.e. destroy + converge + verify + destroy.

bin/kitchen login

Gives you SSH access to the instance for manual testing.

You can’t perform that action at this time.