williamyeh.elasticsearch for Ansible Galaxy

概述

Ansible Galaxy中的角色名称：**williamyeh.elasticsearch**

这个Ansible角色为Elasticsearch提供以下功能：

• 安装Elasticsearch。
• 如有需要，指定JVM的堆大小和G1GC。
• 安装插件（标准和第三方）。
• 基本配置（真实 配置应留给用户的模板文件；请参见下文的使用部分）。

角色变量

必填变量

在用户的playbook中需要定义的变量：

elasticsearch_version

可选变量

用户可安装的配置文件（通过Ansible的模板系统）：

# 要安装的conf文件（通常是elasticsearch.yml），
# 相对于 `playbook_dir`；
# 文件将逐字复制
elasticsearch_conf_copy

# 要安装的conf文件（通常是elasticsearch.yml.j2），
# 相对于 `playbook_dir`；
# 文件将通过Ansible的模板系统复制
elasticsearch_conf_template

用户可安装的插件：

# 要安装的插件数组（在elasticsearch.org注册）。
# @see http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/modules-plugins.html
elasticsearch_plugins

# 其他要安装的插件数组。
# 数组中的每个项目应至少包含以下键：
#  - "name"，插件名称，不包括“.jar”子字符串。
#  - "url"，指向jar文件的url。
elasticsearch_other_plugins

用户可配置的默认值：

# 是否为JVM使用G1GC？
elasticsearch_use_g1gc: false


# Elasticsearch的JVM堆大小
elasticsearch_heap_size

处理程序

• 重启elasticsearch

• 停止elasticsearch

使用方法

第1步：添加角色

将角色名称 williamyeh.elasticsearch 添加到你的playbook文件中。

第2步：添加变量

在你的playbook文件中设置变量。

简单示例：

---
# 文件：simple-playbook.yml

- hosts: all

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

  vars:
    elasticsearch_version: 1.6.0

第3步：调整JVM内存（如有必要）

---
- hosts: all

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

  vars:
    elasticsearch_version: 1.4.2

    elasticsearch_use_g1gc: true
    elasticsearch_heap_size: 6g

第4步：复制用户的配置文件，安装插件等（如有必要）

更实际的示例：

---
# 文件：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

    #-- 逐字复制
    elasticsearch_conf_copy: "files/elasticsearch.yml"

    #-- 通过Ansible的模板系统复制
    #elasticsearch_conf_template: "templates/elasticsearch.yml.j2"

依赖关系

你的目标主机应预先安装JDK。你可以使用williamyeh.oracle-java或Ansible Galaxy中存在的其他角色。

许可证

根据MIT许可证授权。请参见许可证文件了解详细信息。

历史

无。