真正掌握一门技术必须从源码抓起,源码调试环境必不可少,本文介绍如何在本地搭建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或者修改代码后本地调试了。