#######################################################################################################

❗ DEPRECATION ❗

This repository and the role associated are deprecated in favor of the Manala Ansible Collection

You will find informations on its usage on the collection repository

#######################################################################################################

Ansible Role: Elasticsearch

❗ Report issues and send Pull Requests in the main Ansible Role repository ❗

This role will deal with the setup of Elasticsearch.

It's part of the Manala Ansible stack but can be used as a stand alone component.

Requirements

None.

Dependencies

None.

Installation

Ansible 2+

Using ansible galaxy cli:

ansible-galaxy install manala.elasticsearch

Using ansible galaxy requirements file:

- src: manala.elasticsearch

Role Handlers

Name	Type	Description
elasticsearch restart	Service	Restart elasticsearch

Role Variables

Definition

Name	Default	Type	Description
manala_elasticsearch_version	~	String	Version (autodetect if null)
manala_elasticsearch_install_packages	~	Array	Dependency packages to install
manala_elasticsearch_install_packages_default	['elasticsearch']	Array	Default dependency packages to install
manala_elasticsearch_config_file	'/etc/elasticsearch/elasticsearch.yml'	String	Configuration file path
manala_elasticsearch_config_template	~	String	Configuration file template path
manala_elasticsearch_config	~	Array/String	Configuration
manala_elasticsearch_plugins	[]	Array	Plugins
manala_elasticsearch_environment_file	'/etc/default/elasticsearch'	String	Environment file path
manala_elasticsearch_environment_template	~	String	Environment file template path
manala_elasticsearch_environment	~	Array/String	Environment

Example

Config

Use elasticsearch default main config template (recommended):

manala_elasticsearch_config_template: config/elasticsearch/elasticsearch.yml.j2
manala_elasticsearch_config:
  script:
    engine:
      groovy:
        inline:
          aggs: true

Use dict parameters:

manala_elasticsearch_config:
  cluster:
    name: foo
  path.data: /foo/bar

Use raw main config:

manala_elasticsearch_config: |
  cluster:
      name: foo
  path.data: /foo/bar

Use dict's array parameters (deprecated):

manala_elasticsearch_config:
  - cluster.name: foo
  - path.data: /foo/bar

Environment

Use elasticsearch default main environment template (recommended):

manala_elasticsearch_environment_template: environment/elasticsearch/elasticsearch.j2
manala_elasticsearch_environment:
  ES_JAVA_OPTS: -Xms1g -Xmx1g

Use dict parameters:

manala_elasticsearch_environment:
  ES_JAVA_OPTS: -Xms1g -Xmx1g

Use raw main config:

manala_elasticsearch_environment: |
  ES_JAVA_OPTS="-Xms1g -Xmx1g"

Use dict's array parameters (deprecated):

manala_elasticsearch_environment:
  - ES_JAVA_OPTS: -Xms1g -Xmx1g

Plugins

manala_elasticsearch_plugins:
  # Short sytax
  - mobz/elasticsearch-head
  # Verbose syntax
  - name: head
    repository: mobz/elasticsearch-head

Example playbook

- hosts: servers
  roles:
    - role: manala.elasticsearch

Licence

MIT

Author information

Manala (http://www.manala.io/)