influxdb (28) Versions 5.0.2 Follow13

InfluxDB, a timeseries database

Policyfile

Berkshelf

Knife

cookbook 'influxdb', '= 5.0.2', :supermarket

cookbook 'influxdb', '= 5.0.2'

knife supermarket install influxdb

knife supermarket download influxdb

README

Dependencies

Changelog

Quality 100%

InfluxDB

Chef cookbook to install and configure InfluxDB.

Support

Cookbook Version	InfluxDB Version
v5.x.x	>= v1.0.0
v4.4.1	< v1.0.0

Usage

To install InfluxDB and place its configuration file, include the
influxdb::default recipe in your node's run_list. The default recipe
installs the necessary dependencies to use the custom resources defined in this
cookbook.

For rendering the config set the parameter under
node['influxdb']['config']

default['influxdb']['config']['MyParameter'] = 'val'

Resources

The following gems are used by the custom resources and are installed by the
default recipe:

This cookbook ships with five custom resources for managing the configuration
file, users, databases, cluster admins, and retention policies:

influxdb_config

This resource writes a configuration file for InfluxDB based on the passed
configuration hash:

influxdb_config node['influxdb']['config_file_path'] do
  config node['influxdb']['config']
  action :create
end

This resource is used by the default recipe to place the configuration
defined in node['influxdb']['config'].

influxdb_database

Configures an InfluxDB database.

influxdb_database 'my_db' do
  action :create
end

influxdb_install

This resource sets up or removes the appropriate repositories and
installs/removes the appropriate packages

influxdb_install 'influxdb' do
  arch_type 'amd64' # if undefined will auto detect
  include_repository true # default
  influxdb_key 'https://repos.influxdata.com/influxdb.key' # default
  action :install # default
end

influxdb_install 'influxdb' do
  action :remove
end

influxdb_user

This resources configures a user to interact with InfluxDB databases.

influxdb_user 'user' do
  password 'changeme'
  databases ['my_db']
  action :create
end

influxdb_admin

This resources configures a cluster admin to interact with InfluxDB.

influxdb_admin 'admin' do
  password 'changeme'
  action :create
end

influxdb_retention_policy

This resources configures a retention policy on a given database. The name
attribute is not used, the database and policy name provide the unique names
used by InfluxDB.

Note: in v1.0.0+ there is an auto-generated default profile called autogen.
To make your policy the default, you will want to set default parameter
true.

influxdb_retention_policy "foodb default retention policy" do
  policy_name 'default'
  database 'foodb'
  duration '1w'
  replication 1
  action :create
end

influxdb_continuous_query

This resources configures a continuous query on a given database.

influxdb_continuous_query "test_continuous_query" do
  database 'foodb'
  query 'SELECT min(mouse) INTO min_mouse FROM zoo GROUP BY time(30m)'
  action :create
end

Client Libraries

Right now, this cookbook only supports the Ruby and CLI client libraries so as
not to add too many dependencies. That might change in the near future. By
default both flavors are disabled. Enable e.g. Ruby via:

node.default['influxdb']['client']['ruby']['enable'] = true

Finally include the influxdb::client in your node's run_list to install the
clients.

Tests

To run tests, install all dependencies with bundler:

bundle install

Then to run tests:

rake # Quick tests only (rubocop + minitest)
rake test:complete # All tests (rubocop + minitest + kitchen)

Release Steps

Run through Deploy step in Wercker
cd ..; knife supermarket share influxdb "Monitoring & Trending" -o .

License

This project is licensed under the MIT license

Maintainers

Ben Dang me@bdang.it

E Camden Fisher fish@fishnix.net

Dependent cookbooks

nodejs ~> 2.4

chef_handler >= 0.0.0

apt >= 3.0

yum >= 3.0

compat_resource >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

CHANGELOG

5.0.2

[patch] handle InfluxDB::Error when auth enabled without admin user (contributed by @jschnare)

5.0.1

[patch] relax apt and yum dependencies (contributed by @dpattmann)

5.0.0

[major] Support for 1.0.x which is not backward compatible
[major] Updated apt cookbook pin to ~> 4.0
[major] Updated yum cookbook pin to ~> 4.0
[minor] Reduce number of TK Cases to 12.1, 12.7 and 12.14.
[patch] removed specific branch used for compat_resource

4.4.1

Add steps to cut release
Fix invalid property type 'nil' in continuous query options (contributed by @kentarosasaki)

4.4.0

Added support for file install type (contributed by @chrisduong)
Added extra continuous query options (contributed by @cyberflow)
Make docker default driver for Test Kitchen

4.3.0

Added influxdb_continuous_query (contributed by @cyberflow)

4.2.0

Added influxdb_install resource (contributed by @majormoses)

4.1.0

Updated attributes to support Influxdb 0.10.0
Set default resource actions (:create is default)
Fixed support for Chef-Client 12.6
Fixed rubocop styling
Added functional test to check restarts service restarts on config change

4.0.1

License update from Apache 2.0 to MIT
- transfer of ownership

4.0.0

Support for RHEL
Support for Chef-Client 12.1+
Support 0.9.5+
Added ChefSpec Matchers
Use toml-rb instead of toml

3.0.0

Update to influxdb gem 0.2.x, which is not backwards compatible (contributed by @cmjosh)

2.7.0

Add :stop action, remove :delete action from influxdb resource (contributed by @alvaromorales)

2.6.2

Allow configuration options for databases (contributed by @wosc)

2.6.1

Enable custom version of influxdb gem (contributed by @kri5)

2.6.0

Support for 0.9.x release of InfluxDB (contributed by @rberger)

2.5.0

Move influxdb resource actions to an attribute (contributed by @directionless)

2.4.0

Update default config for 0.8.5 and up (contributed by @tjwallace)

2.3.0

Update checksums for 0.8.6 (contributed by @tjwallace)

2.2.2

Touch logfile if it does not exist (contributed by @odolbeau)

2.2.1

Updated latest checksum to be accurate (contributed by @nomadium)

2.2.0

Added dbadmin parameter to influxdb_user, allowing granular control of which users are admins for which databases (contributed by @BarthV)

2.1.1

User and admin deletion now idempotent (contributed by @flowboard)

2.1.0

Multiple style and testing updates (contribued by @odolbeau)

2.0.4

Default logfile path is now the Debian package default (contributed by @masarakki)

2.0.3

Fixed typo in cluster admin check per InfluxDB 0.6.0 (contributed by @Chelo)

Collaborator Number Metric

5.0.2 passed this metric

Foodcritic Metric

5.0.2 passed this metric

Adoptable Cookbooks List

Supermarket Belongs to the Community

View our collection of guides, documentation, and articles

Select Badges

Select Supported Platforms

Select Status

influxdb (28) Versions 5.0.2 6.3.1 6.3.0 6.2.0 6.1.3 6.1.2 6.1.0 6.0.0 5.2.2 5.2.1 5.2.0 5.1.0 5.0.3 5.0.2 5.0.1 5.0.0 4.4.2 4.4.1 4.4.0 4.2.0 4.1.0 4.0.1 4.0.0 2.6.0 0.1.4 0.1.3 0.1.2 0.1.1 0.1.0 Follow13

InfluxDB

Support

Usage

Resources

influxdb_config

influxdb_database

influxdb_install

influxdb_user

influxdb_admin

influxdb_retention_policy

influxdb_continuous_query

Client Libraries

Tests

Release Steps

License

Maintainers

Dependent cookbooks

Contingent cookbooks

CHANGELOG

5.0.2

5.0.1

5.0.0

4.4.1

4.4.0

4.3.0

4.2.0

4.1.0

4.0.1

4.0.0

3.0.0

2.7.0

2.6.2

2.6.1

2.6.0

2.5.0

2.4.0

2.3.0

2.2.2

2.2.1

2.2.0

2.1.1

2.1.0

2.0.4

2.0.3

Collaborator Number Metric 5.0.2 passed this metric

Foodcritic Metric 5.0.2 passed this metric

Details

Updated October 7, 2016 Created on August 1, 2014

Supported Platforms

License

Required Chef Infra Client

influxdb (28) Versions 5.0.2 Follow13

Collaborator Number Metric

5.0.2 passed this metric

Foodcritic Metric

5.0.2 passed this metric