搭建Elasticsearch源码调试环境 elasticsearch _source enable

真正掌握一门技术必须从源码抓起，源码调试环境必不可少，本文介绍如何在本地搭建Elasticsearch源码调试环境。

环境准备：

• Elasticsearch7.13.2
• Idea2021版本
• gradle
• git
• Java

一、下载Elasticsearch源码

直接从elasticsearch仓库克隆代码到本地：

git clone https://github.com/elastic/elasticsearch.git

更加建议的是从自己的代码仓库中克隆：

1、在github上创建自己的账号，然后从elasticsearch fork到自己的仓库中

2、使用git将代码clone到自己的本地，使用git checkout将版本切换到7.13版本

二、安装多版本的JDK

由于编译Elasticsearch的需要，在Mac系统下需要安装多个JDK的版本，从JDK8～JDK15，以下说明安装和动态切换过程。

1、查看默认安装的JDK

lucas-os@zyingdeMacBook:~/workspace/elasticsearch$ java -version
java version "11" 2018-09-25
Java(TM) SE Runtime Environment 18.9 (build 11+28)
Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11+28, mixed mode)

2、使用以下命令查看安装路径：

lucas-os@zyingdeMacBook:~/workspace/elasticsearch$ /usr/libexec/java_home -v 11
/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home

3、下载JDK8～JDK16对应版本dmg格式的安装包，按照默认配置进行安装，安装以后查看/Library/Java/JavaVirtualMachines/目录。

4、配置~/.bash_profile文件

#JDK8
export JAVA8_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_291.jdk/Contents/Home
#JDK9
export JAVA9_HOME=/Library/Java/JavaVirtualMachines/jdk-9.0.4.jdk/Contents/Home
#JDK10
export JAVA10_HOME=/Library/Java/JavaVirtualMachines/jdk-10.0.2.jdk/Contents/Home
#JDK11
export JAVA11_HOME=/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home
#JDK12
export JAVA12_HOME=/Library/Java/JavaVirtualMachines/jdk-12.0.2.jdk/Contents/Home
#JDK13
export JAVA13_HOME=/Library/Java/JavaVirtualMachines/jdk-13.0.2.jdk/Contents/Home
#JDK14
export JAVA14_HOME=/Library/Java/JavaVirtualMachines/jdk-14.0.2.jdk/Contents/Home
#JDK15
export JAVA15_HOME=/Library/Java/JavaVirtualMachines/jdk-15.0.2.jdk/Contents/Home
#JDK16
export JAVA16_HOME=/Library/Java/JavaVirtualMachines/jdk-16.0.1.jdk/Contents/Home
#Default JDK
export JAVA_HOME=$JAVA15_HOME

#alias命令动态切换JDK版本
alias jdk8="export JAVA_HOME=$JAVA8_HOME"
alias jdk9="export JAVA_HOME=$JAVA9_HOME"
alias jdk10="export JAVA_HOME=$JAVA10_HOME"
alias jdk11="export JAVA_HOME=$JAVA11_HOME"
alias jdk12="export JAVA_HOME=$JAVA12_HOME"
alias jdk13="export JAVA_HOME=$JAVA13_HOME"
alias jdk14="export JAVA_HOME=$JAVA14_HOME"
alias jdk15="export JAVA_HOME=$JAVA15_HOME"
alias jdk16="export JAVA_HOME=$JAVA16_HOME"

5、动态切换

使用alias命令配置jdk别名，可以使用jdk8~jdk16动态切换默认的jdk。

三、导入Idea

1、打开IDEA，File->New_->Project from Existing Sources,选择导入为gradle工程(elasticsearch是使用gradle作为管理和编译工具的。)

2、构建工程

./gradlew run

这时候会使用工程默认指定的gradle下载依赖项，然后进行工程构建启动本地elasticsearch实例。

lucas-os@zyingdeMacBook:~/workspace/elasticsearch$ ./gradlew run
=======================================
Elasticsearch Build Hamster says Hello!
  Gradle Version        : 7.0.1
  OS Info               : Mac OS X 10.13.6 (x86_64)
  JDK Version           : 16.0.1 (Oracle)
  JAVA_HOME             : /Library/Java/JavaVirtualMachines/jdk-16.0.1.jdk/Contents/Home
  Random Testing Seed   : FE7643423B53C5E9
  In FIPS 140 mode      : false
=======================================

> Task :run
.
.
.
.
.
.
<============-> 99% EXECUTING [32m 25s]
> :run
> IDLE
> IDLE
> IDLE

当看到以上输出的时候证明本地elasticsearch已经启动成功，这时候在浏览器上输入`localhost:9200`,会提示输入账号和密码，这是因为elasticsearch内置了一些用户和角色，用以提供认证功能，默认情况下这些用户是没有设置密码的，在设置密码前无法访问。

这些角色有elastic、apm_system、kibana_system、logstash_system、beats_system、remote_monitoring_user。

由于默认的xpack.security.enabled的值为true，所以开启了认证，为了方便可以将此先配置为false。

xpack.security.enabled: false

此时可以看到集群的相关信息：

{
  "name" : "runTask-0",
  "cluster_name" : "runTask",
  "cluster_uuid" : "wqWiRAWJS1a8ie9Tic9L3A",
  "version" : {
    "number" : "7.13.2-SNAPSHOT",
    "build_flavor" : "default",
    "build_type" : "zip",
    "build_hash" : "e8def7f7024f26aa14eeb68a69dafc3ee2c2ad47",
    "build_date" : "2021-06-12T03:55:12.931748900Z",
    "build_snapshot" : true,
    "lucene_version" : "8.8.2",
    "minimum_wire_compatibility_version" : "6.8.0",
    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },
  "tagline" : "You Know, for Search"

此时就已经完成了整体环境的搭建，可以进行debug或者修改代码后本地调试了。