William-Yeh.elasticsearch

Przegląd Wersje Wgląd

williamyeh.elasticsearch dla Ansible Galaxy

Podsumowanie

Nazwa roli w Ansible Galaxy: williamyeh.elasticsearch

Ta rola Ansible ma następujące funkcje dla Elasticsearch:

Instalacja Elasticsearch.
Określenie rozmiaru pamięci i G1GC dla JVM, jeśli jest to wymagane.
Instalacja wtyczek (standardowych i zewnętrznych).
Podstawowa konfiguracja (prawdziwą konfigurację należy zostawić plikom szablonów użytkownika; zobacz sekcję Użycie poniżej).

Zmienne roli

Obowiązkowe zmienne

Zmienna, która musi być określona w pliku playbooka użytkownika:

elasticsearch_version

Opcjonalne zmienne

Pliki konfiguracyjne instalowane przez użytkownika (za pomocą systemu szablonów Ansible):

# plik konfiguracyjny (zwykle elasticsearch.yml) do zainstalowania,
# w odniesieniu do `playbook_dir`;
# plik zostanie skopiowany w oryginalnej formie
elasticsearch_conf_copy

# plik konfiguracyjny (zwykle elasticsearch.yml.j2) do zainstalowania,
# w odniesieniu do `playbook_dir`;
# plik zostanie skopiowany przez system szablonów Ansible
elasticsearch_conf_template

Wtyczki instalowane przez użytkownika:

# tablica wtyczek (zarejestrowanych w elasticsearch.org) do zainstalowania.
# @see http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/modules-plugins.html
elasticsearch_plugins

# tablica innych wtyczek do zainstalowania.
# każdy element w tablicy powinien mieć przynajmniej następujące klucze:
#  - "name", nazwa wtyczki bez fragmentu ".jar".
#  - "url", prowadzący do adresu URL pliku jar.
elasticsearch_other_plugins

Domyślne ustawienia konfigurowane przez użytkownika:

# używać G1GC dla JVM?
elasticsearch_use_g1gc: false

# rozmiar pamięci JVM dla Elasticsearch
elasticsearch_heap_size

Handlery

restartuj elasticsearch
zatrzymaj elasticsearch

Użycie

Krok 1: dodaj rolę

Dodaj nazwę roli williamyeh.elasticsearch do swojego pliku playbook.

Krok 2: dodaj zmienne

Ustaw zmienne w swoim pliku playbook.

Prosty przykład:

---
# plik: simple-playbook.yml

- hosts: all

  roles:
    - williamyeh.oracle-java
    - williamyeh.elasticsearch

  vars:
    elasticsearch_version: 1.6.0

Krok 3: dostosuj pamięć JVM, jeśli to konieczne

---
- hosts: all

  roles:
    - williamyeh.oracle-java
    - williamyeh.elasticsearch

  vars:
    elasticsearch_version: 1.4.2

    elasticsearch_use_g1gc: true
    elasticsearch_heap_size: 6g

Krok 4: skopiuj plik konfiguracyjny użytkownika, zainstaluj wtyczki itp., jeśli to konieczne

Bardziej praktyczny przykład:

---
# plik: complex-playbook.yml

- hosts: all

  roles:
    - williamyeh.oracle-java
    - williamyeh.elasticsearch

  vars:
    elasticsearch_version: 1.4.2

    elasticsearch_plugins:
      - elasticsearch/marvel/latest
      - lmenezes/elasticsearch-kopf

    elasticsearch_other_plugins:
      - name: analysis-ik
        url:  https://github.com/medcl/elasticsearch-rtf/raw/master/plugins/analysis-ik/elasticsearch-analysis-ik-1.2.6.jar
        memo: https://github.com/medcl/elasticsearch-analysis-ik

    #-- kopiuj w oryginalnej formie
    elasticsearch_conf_copy: "files/elasticsearch.yml"

    #-- kopiuj przez system szablonów Ansible
    #elasticsearch_conf_template: "templates/elasticsearch.yml.j2"