https://github.com/manala/ansible-role-influxdb

[READ-ONLY] Ansible role dealing installation and configuration of InfluxDB time-series database
https://github.com/manala/ansible-role-influxdb

Last synced: about 1 month ago
JSON representation

[READ-ONLY] Ansible role dealing installation and configuration of InfluxDB time-series database

• Host: GitHub
• URL: https://github.com/manala/ansible-role-influxdb
• Owner: manala
• Archived: true
• Created: 2016-06-17T09:07:58.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2021-12-16T10:49:37.000Z (almost 3 years ago)
• Last Synced: 2024-04-27T07:31:56.475Z (5 months ago)
• Language: Jinja
• Homepage: https://galaxy.ansible.com/manala/influxdb/
• Size: 85.9 KB
• Stars: 12
• Watchers: 5
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

README

        
# Ansible Role : InfluxDB [![Build Status](https://travis-ci.org/manala/ansible-role-influxdb.svg?branch=master)](https://travis-ci.org/manala/ansible-role-influxdb)

:exclamation: [Report issues](https://github.com/manala/ansible-roles/issues) and [send Pull Requests](https://github.com/manala/ansible-roles/pulls) in the [main Ansible Role repository](https://github.com/manala/ansible-roles) :exclamation:

This role will assume the setup of [InfluxDB](https://www.influxdata.com/time-series-platform/influxdb/).

It's part of the [Manala Ansible stack](http://www.manala.io) but can be used as a stand alone component.

## Requirements

This role is made to work with the __influxdata__ influxDB debian packages. Please use the [**manala.apt**](https://galaxy.ansible.com/manala/apt/) role to handle it properly.

```yaml

manala_apt_preferences:

  - influxdb@influxdata

```

## Dependencies

None.

## Supported InfluxDB versions

0.13.0+

## Installation

### Ansible 2+

Using ansible galaxy cli:

```bash

ansible-galaxy install manala.influxdb

```

Using ansible galaxy requirements file:

```yaml

- src: manala.influxdb

```

## Role Handlers

| Name               | Type    | Description             |

| ------------------ | ------- | ----------------------- |

| `influxdb restart` | Service | Restart influxdb server |

## Role Variables

| Name                                       | Default                       | Type         | Description                            |

| ------------------------------------------ | ----------------------------- | ------------ | -------------------------------------- |

| `manala_influxdb_install_packages`         | ~                             | Array        | Dependency packages to install         |

| `manala_influxdb_install_packages_default` | ['influxdb']                  | Array        | Default dependency packages to install |

| `manala_influxdb_dir`:                     | []                            | Array        | Directories used by Influxdb           |

| `manala_influxdb_databases`                | []                            | Array        | Databases                              |

| `manala_influxdb_users`                    | []                            | Array        | Users                                  |

| `manala_influxdb_privileges`               | []                            | Array        | Privileges                             |

| `manala_influxdb_config`                   | ~                             | Array/String | Configuration                          |

| `manala_influxdb_config_file`              | '/etc/influxdb/influxdb.conf' | String       | Configuration file path                |

| `manala_influxdb_config_template`          | 'config/base.conf.j2'         | String       | Configuration template path            |

### Configuration example

Use influxdata default main config template (recommended):

```yaml

manala_influxdb_config_template: config/influxdata/influxdb.conf.j2

manala_influxdb_config:

  reporting-disabled: true

  meta:

    dir: /srv/db/influxdb/meta

  http:

    enabled: true

  udp:

    - enabled: true

      bind-address: :8090

      database: app

```

Use dict parameters:

```yaml

manala_influxdb_config:

  reporting-disabled: true

  meta:

    dir: /srv/db/influxdb/meta

  http:

    enabled: true

  udp:

    - enabled: true

      bind-address: :8090

      database: app

```

Use raw config:

```yaml

manala_influxdb_config: |

  reporting-disabled = true

  [meta]

    dir = "/srv/db/influxdb/meta"

  [http]

    enabled = true

  [[udp]]

    enabled = true

    bind-address = ":8090"

    database = "app"

```

Use dict's array parameters (deprecated):

```yaml

manala_influxdb_config:

  - reporting-disabled: true

  - meta:

    - dir: /srv/db/influxdb/meta

  - http:

    - enabled: true

  - udp:

    - enabled: true

    - bind-address: :8090

    - database: app

```

Databases & Users & Privileges:

```yaml

manala_influxdb_databases:

  - my_db

manala_influxdb_users:

  - database: my_db

    name: my_user

    password: my_password

manala_influxdb_privileges:

  - database: my_db

    user: my_user

    grant: ALL

```

See InfluxDB documentation for more information about [databases](https://docs.influxdata.com/influxdb/v0.13/query_language/database_management/#data-management), [users and privileges](https://docs.influxdata.com/influxdb/v0.13/administration/authentication_and_authorization/)

## Example playbook

 ```yaml

 - hosts: servers

   roles:

     - role: manala.influxdb

 ```

# Licence

MIT

# Author information

Manala [**(http://www.manala.io/)**](http://www.manala.io)