Mac环境下编译Elasticsearch源码并导入IDEA

参考：《Elasticsearch源码解析与优化实战》-张超

 

1.下载Elasticsearch源码

此处下载的源码版本为6.1.2，下载后解压文件：

https://github.com/elastic/elasticsearch/releases

 

2.安装Gradle

由于Elasticsearch5.0之后使用Gradle构建，因此需要安装Gradle，mac下安装Gradle也比较简单，直接通过homebrew安装即可：

brew install gradle

需要注意的是通过此种方式安装的gradle是最新版本的gradle，gradle版本可能对编译有影响，最初安装gradle 5.1.1的版本，在执行gradle idea命令时构建失败，因此与书中的版本保存了一致，将gradle降级到了4.6版本，gradle降版本的方法可参考：

homebrew 安装指定版本gradle（软件）

 

3.编译打包

（1）确保已经安装了JDK，并设置了JAVA_HOME环境变量，此处使用的JDK版本为1.8.0.121

echo $JAVA_HOME

查看是否设置JAVA_HOME环境变量，如果输出JDK信息说明已经配置过，如果未设置可参考在Mac下配置JAVA_HOME设置JAVA_HOME环境变量。

（2）进入到Elasticsearch源码解压后的目录，在该目录下执行：

./gradlew assemble

如果输出BUILD SUCCESSFUL表示构建成功。

（3）生成IDEA项目文件

gradle idea

同样，如果最后输出输出BUILD SUCCESSFUL表示构建成功。

 

4.创建用于ES读取配置的目录

创建一个目录，此处命名为eshome，用于ES从中加载模块读取配置写入数据和日志，可以将gradle编译打包的软件包解压，然后将config、modules、plugins目录拷贝到eshome文件夹中，软件包位于distribution/zip/build/distributions下：

（1）在ES源码解压后的目录下，执行下面的命令进入gradle打包后的软件包所在目录：

cd distribution/zip/build/distributions

（2）解压zip文件，并进入解压后的目录：

 unzip elasticsearch-6.1.2-SNAPSHOT.zip
 cd elasticsearch-6.1.2-SNAPSHOT

（3）将config、modules、plugins目录拷贝到eshome目录：

cp -r config modules plugins /Users/shanmenglu/Documents/eshome/

5.导入idea

（1）选择import project，将源码加压后的文件目录导入，选择gradle

配置JVM和gradle home

导入后:

（2）IDEA菜单中选择Run->Edit Configurations，点击“+”添加Application,配置下列信息：

其中vm options配置如下：

-Des.path.home=/Users/shanmenglu/Documents/eshome
-Des.path.conf=/Users/shanmenglu/Documents/eshome/config
-Xms1g
-Xmx1g
-Dlog4j2.disable.jmx=true
-Djava.security.policy=/Users/shanmenglu/Documents/eshome/config/elasticsearch.policy

Main Class配置启动类，该类在core目录下src/java/org/elasticsearch/bootstrap/Elasticsearch.java