Elasticsearch Build 방법

Prerequisite

Elasticsearch 빌드를 위해서는 Java가 필요하다.

 

8.x 버전 빌드에는 Java 17 버전이 필요하며

7.x 버전 빌드에는 Java 11 버전이 필요하다.

 

Ubuntu 환경에서 Elasticsearch 8.1.2 버전 기준 빌드 방법은 다음과 같다.

 

 

Build From Source

1. Java 17 다운로드

 - Java 설치에는 여러 가지 방법이 있는데, 필자는 Azul Zulu를 통한 설치를 추천한다.

 - 테스트해 봤을 때 설치가 가장 쉽고 성공적으로 적용된다. 더불어 장점도 많다.

 - 아래 사이트에서 .deb 버전으로 다운로드한다.

 

https://www.azul.com/downloads/?version=java-17-lts&os=ubuntu&architecture=x86-64-bit&package=jdk 

Downloads

 

2. Java 17 설치

$ sudo apt install ./zulu17.32.13-ca-jdk17.0.2-linux_amd64.deb

 

 

3. Elasticsearch 소스 다운로드

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

 

4. Elasticsearch 버전 선택

 - 사용 가능한 버전은 릴리즈 페이지에서 확인할 수 있다.
  https://github.com/elastic/elasticsearch/releases

Releases · elastic/elasticsearch

 

 - v8.1.2 버전을 선택한다.

$ cd elasticsearch
$ git checkout tags/v8.1.2

 

 - 아래와 같이 "Note: switching to 'tags/v8.1.2'가 출력되면 성공

 

5. Build Elasticsearch

 - Build를 실행하는 OS에서 사용할 수 있는 ES 버전으로 빌드를 수행한다.
   (필자의 PC 환경으로 5분 소요)

$ ./gradlew localDistro

 

6. Build 결과 확인

 - 빌드가 완료되면 build 폴더가 생성되어 있고 build/distribution/local/elasticsearch-8.1.2-SNAPSHOT 위치에서 결과물을 확인할 수 있다.

$ cd build/distribution/local/elasticsearch-8.1.2-SNAPSHOT

 

7. Elasticsearch 실행

 - bin 폴더로 이동하여 elasticsearch 파일을 실행한다.

$ cd bin
$ ./elasticsearch

 

8. Elasticsearch 테스트

 - 8.x 버전부터는 접속에 인증서가 필요하다. config/certs/http_ca.crt 를 사용하면 된다.

 - http_ca.crt를 적절한 위치에 복사하고 아래 명령어 실행. 초기 비밀번호는 실행된 Elasticsearch 콘솔에 출력되어 있으니 사용한다.

$ curl --cacert http_ca.crt -u elastic https://localhost:9200

 

 - 빌드한 ES가 성공적으로 실행되고 있다.

 

출처 : https://github.com/elastic/elasticsearch