lae.elasticsearch

Installs and configures Elasticsearch as part of a multi-node cluster.

Notes

This Ansible role does not start or restart Elasticsearch on changes as there is a lack of configuration file validation tools. This role will inform you if a restart is needed, however, so please do so then.

Please note that most configuration decisions (like the above) within this role are meant for production clusters, which may not make this role suitable for dev environments. (The intention is to cater to both eventually.)

You should, in a separate role or playbook, configure the software firewall on the machines in your cluster to only allow each other to communicate with each other on your transport port. You will likely want to also use a whitelist for Elasticsearch API clients for the HTTP port.

Requirements

This role assumes you hava Java already installed. Elastic 2 requires JDK 7 or higher and Elastic 5 requires JDK 8.

Role Variables

Mandatory Variables

You must define elasticsearch_cluster_name to identify your Elasticsearch cluster, either in the playbook or in a group variables file.

Optional Variables

The following variables are used in the elasticsearch configuration file. Please review templates/elasticsearch.yml.j2 for more detailed notes. Most variables below have saner defaults in this file.

Likely to be defined per host:

# The following defaults to 'ansible_hostname' (hopefully sane)
elasticsearch_node_name: machine03
elasticsearch_node_attributes: []
elasticsearch_path_data: /mnt/disk1,/mnt/disk2,/mnt/disk3

Likely to be defined per cluster/group (or all):

elasticsearch_major_version: 2
elasticsearch_minor_version: 4
elasticsearch_path_logs: /var/log/elasticsearch
elasticsearch_http_port: 9210
# https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-network.html#network-interface-values
elasticsearch_network_host: "{{ ansible_default_ipv4.address }}"
elasticsearch_disable_deletion_of_all_indices: false

There are other optional variables in the defaults file that you may want to review. More documentation will be added here later.

Example Playbook

The following sets up an Elasticsearch 5.x cluster using @William-Yeh's Java role to install Oracle Java 8:

---
- hosts: cluster01
  become: True
  roles:
    - srsp.oracle-java
    - lae.elasticsearch
  vars:
    elasticsearch_cluster_name: cluster01
    elasticsearch_hostgroup: cluster01
    elasticsearch_hostgroup_discovery: cluster01_discovery
    elasticsearch_major_version: 5
    elasticsearch_minor_version: 0
    elasticsearch_network_host: _global_

License

MIT

Author Information

Thanks to:

Musee "lae" Ullah - original author
Christopher "tankbusta" Schmitt - elasticsearch 5.x support