ansible-roles/elasticsearch
Jérémy Lecour 5091157b18 Elasticsearch: defaults to version 6.x 2018-05-16 11:03:24 +02:00
..
defaults Elasticsearch: defaults to version 6.x 2018-05-16 11:03:24 +02:00
files merge elastic sources back into roles 2017-07-13 14:43:07 +02:00
handlers Fix systemd handler to restart elasticsearch with systemd 2017-08-04 10:48:49 -04:00
meta cleanup with dependencies on java8 2017-10-08 22:31:22 +02:00
tasks add "become" when missing 2018-04-04 23:22:17 +02:00
templates Elasticsearch logs can have multiple patterns 2017-12-19 18:08:29 +01:00
README.md elasticsearch: RESTART_ON_UPGRADE is configurable 2018-02-20 15:06:07 +01:00

README.md

elasticsearch

Install Elasticsearch.

Tasks

Tasks are extracted in several files, included in tasks/main.yml :

  • packages.yml : install packages ;
  • configuration.yml : configure the service;
  • bootstrap_checks.yml : deal with bootstrap checks;
  • datadir.yml : data directory customization ;
  • tmpdir.yml : temporary directory customization ;

Available variables

  • elasticsearch_cluster_name: cluster name ;
  • elasticsearch_node_name: node name, defaults to hostname ;
  • elasticsearch_network_host: which interfaces to bind to ;
  • elasticsearch_network_publish_host: which interface to publish ;
  • elasticsearch_custom_datadir: custom datadir ;
  • elasticsearch_custom_tmpdir: custom tmpdir ;
  • elasticsearch_jvm_xms: mininum heap size reserved for the JVM (default: 2g).
  • elasticsearch_jvm_xmx: maximum heap size reserved for the JVM (default: 2g).
  • elasticsearch_restart_on_upgrade: restart the service after package upgrade (default: true)

By default, Elasticsearch will listen to the public interfaces (_site_ cf. https://www.elastic.co/guide/en/elasticsearch/reference/5.0/important-settings.html#network.host), so you will have to secure it, with firewall rules for example.

Curator

Curator can be installed. :

  • elasticsearch_curator : enable the package installation (default: False) ;

Head plugin

The "head" plugin can be installed :

  • elasticsearch_plugin_head : enable the plugin installation (default: False) ;
  • elasticsearch_plugin_head_basedir: base directory (default : /var/www) ;
  • elasticsearch_plugin_head_clone_name: directory name for git clone.

To use this plugin, you have to run the built-in webserver (using Grunt/NodeJS), or point a webserver to the path. More details here : https://github.com/mobz/elasticsearch-head#running-with-built-in-server

For example, to run the built-in server, with "www-data" user :

# sudo -u www-data bash -c 'cd /var/www/elasticsearch-head && grunt server'