一键部署高可用 Elasticsearch 集群

1. 此安装部署程序运行环境要求： Ansible >= 2.5（es 部署节点无须安装，只需确保有 SSH 登录权限）
2. 支持部署的 es 版本：5.x, 6.x, 7.x

:rocket: 快速使用说明

第一步：修改配置项

拷贝或直接修改 example.cfg 配置文件，填写 集群名称、es 版本.. 等信息。

第二步：节点 ES_HEAP_SIZE 配置

根据自身环境配置，修改 vars 目录下，节点角色对应名称配置文件的 jvm_heap_size 默认值至合适大小。

master 角色节点修改 master.yml 文件，mix 节点修改 mix.yml 文件...，文件中其他配置项按需也可以修改。所有相同角色节点使用相同配置。

第三步：一键安装

ansible-playbook -i example.cfg setup.yml -v

第四步：启动集群

安装完毕后进入 /home/<部署用户>/<project_name>/<cluster_name>/elasticsearch目录，内含 start_elasticsearch.sh 启动脚本。执行 sh start_elasticsearch.sh 命令启动 es 服务即可。

第五步：部署完毕

执行到这里部署就已经完毕了！可以使用 GET /_cat/health?v 等命令确认集群服务是否正常。ENJOY!

:fire: 其他事项

1. 关于节点角色说明：如果部署的集群为生产环境使用，建议区分 es 节点角色 master/data/client，性能和稳定性更好（在配置文件中配上 [master]/[data]/[client] 组选项）。如果部署的集群为测试环境使用或仅为功能验证，希望尽量节省资源，对稳定性和性能无要求，可以使用 mix 模式集群（在配置文件中删除或注释掉 [master]/[data]/[client] 配置）。

2. 安装程序会自动下载并安装配置 Oracle JDK_1.8 环境，如果有现成或想使用自己的 Java 运行环境，可以在安装命令中添加如下选项跳过：

--skip-tags java

3. 如果当前用户 session 的 java 环境未生效（如找不到 Java 命令等），可能是当前用户在安装部署前已登录，可以手动执行一下 source ~/.profile 命令，重新加载 Java 配置。

4. 安装过程中首先会对目标节点系统配置进行检查，以确认是否能满足 es 部署要求。检查项为 Elasticsearch 官方要求满足的系统配置项。另外还可检测 磁盘 io 调度策略及磁盘文件系统类型，目前 磁盘 io 调度策略及磁盘文件系统类型检测默认为关闭状态，如需要可通过添加 tags 选项开启：

--tags scheduler,filesystem,all

5. 如果上一步检查中的 es 官方要求系统配置项不通过，且安装部署的用户具有 sudo 权限，则可以在安装命令中添加 tags 来要求用安装程序自动配置 Elasticsearch 官方要求的系统配置项。否则需要提前配置完毕。tags 如下：

--tags superuser,all

6. 集群会默认安装开源 IK 中文分词器，如不需要，可使用 skip tags 跳过：

--skip-tags ik

更多安装部署程序介绍及高级用法还可以参考：这里。

:swan: Logstash 部署说明

Logstash 部署说明文档：Logstash setup usage

:dodo: Kibana 部署说明

Kibana 部署说明文档：Kibana setup usage

:whale: 部署后目录结构示例

project-name
└── cluster-name
    ├── elasticsearch
    │   ├── config
    │   │   ├── client0
    │   │   ├── data0_0
    │   │   └── master1
    │   ├── data
    │   │   ├── data0_0
    │   │   └── master1
    │   ├── logs
    │   │   ├── client0
    │   │   ├── data0_0
    │   │   └── master1
    │   └── start_elasticsearch.sh
    ├── kibana
    │   ├── config
    │   ├── data
    │   ├── logs
    │   └── start_kibana.sh
    └── logstash
        ├── config
        ├── data
        ├── logs
        └── start_logstash.sh

:memo: License

This project is Apache 2.0 licensed.