https://docs.opensearch.org/latest/getting-started/quickstart/

OpenSearch 설치 빠른 시작

OpenSearch는 여러 설치 방법을 지원합니다: Docker, Debian, Helm, RPM, tarball, Windows. 이 가이드는 빠른 로컬 설정을 위해 Docker를 사용합니다. 다른 설치 옵션은 전체 "OpenSearch 설치 및 업그레이드 가이드"를 참조하세요.

시작하는 방법은 두 가지입니다:

1. 단일 명령으로 OpenSearch 체험 – 빠른 데모에 적합
2. 커스텀 Docker 클러스터 설정 – 더 많은 제어가 필요할 때 이상적

사전 요구사항

시작하기 전에 컴퓨터에 Docker를 설치하세요.

옵션 1: 단일 명령으로 OpenSearch 체험

이 방법을 사용하여 최소한의 설정으로 로컬 머신에서 OpenSearch를 빠르게 실행할 수 있습니다.

⚠️ 주의: 이 구성은 보안을 비활성화하므로 테스트 환경에서만 사용해야 합니다.

OpenSearch 다운로드 및 실행:

docker pull opensearchproject/opensearch:latest && docker run -it -p 9200:9200 -p 9600:9600 -e "discovery.type=single-node" -e "DISABLE_SECURITY_PLUGIN=true" opensearchproject/opensearch:latest

이 과정은 시간이 걸릴 수 있습니다. 완료되면 OpenSearch가 포트 9200에서 실행됩니다. OpenSearch가 실행 중인지 확인하려면 다음 요청을 보내세요:

curl http://localhost:9200

다음과 같은 응답을 받아야 합니다:

{
  "name" : "a937e018cee5",
  "cluster_name" : "docker-cluster",
  "cluster_uuid" : "GLAjAG6bTeWErFUy_d-CLw",
  "version" : {
    "distribution" : "opensearch",
    "number" : <version>,
    "build_type" : <build-type>,
    "build_hash" : <build-hash>,
    "build_date" : <build-date>,
    "build_snapshot" : false,
    "lucene_version" : <lucene-version>,
    "minimum_wire_compatibility_version" : "7.10.0",
    "minimum_index_compatibility_version" : "7.0.0"
  },
  "tagline" : "The OpenSearch Project: https://opensearch.org/"
}

옵션 2: 커스텀 Docker 클러스터 설정

Docker Compose를 사용하여 로컬 다중 노드 OpenSearch와 OpenSearch Dashboards 클러스터를 실행합니다:

• 보안 없는 클러스터 설정 – 로컬 개발에 최적
• 보안이 있는 클러스터 설정 – 기본 인증서를 설치하여 보안과 함께 OpenSearch 체험

보안 없는 클러스터 설정 (로컬 개발용)

이 설정은 보안이 비활성화된 개발용 Docker Compose 파일을 사용합니다.

⚠️ 주의: 이 구성은 보안을 비활성화하므로 테스트 환경에서만 사용해야 합니다.

1. OpenSearch 클러스터용 디렉터리를 생성합니다 (예: opensearch-cluster)
2. 이 디렉터리에 docker-compose.yml 파일을 생성하고 개발용 Docker Compose 파일의 내용을 복사합니다
3. 다음 명령을 실행하여 클러스터를 시작합니다:

docker compose up -d

4. 컨테이너가 실행 중인지 확인합니다:

docker compose ps

다음과 유사한 출력을 볼 수 있습니다:

NAME                    COMMAND                  SERVICE                 STATUS              PORTS
opensearch-dashboards   "./opensearch-dashbo…"   opensearch-dashboards   running             0.0.0.0:5601->5601/tcp
opensearch-node1        "./opensearch-docker…"   opensearch-node1        running             0.0.0.0:9200->9200/tcp, 9300/tcp, 0.0.0.0:9600->9600/tcp, 9650/tcp
opensearch-node2        "./opensearch-docker…"   opensearch-node2        running             9200/tcp, 9300/tcp, 9600/tcp, 9650/tcp

5. OpenSearch가 실행 중인지 확인하려면 다음 요청을 보내세요:

curl http://localhost:9200

옵션 1과 유사한 응답을 받아야 합니다.

이제 http://localhost:5601/에서 OpenSearch Dashboards를 탐색할 수 있습니다.

보안이 있는 클러스터 설정 (대부분의 사용 사례에 권장)

이 구성은 데모 인증서를 사용하여 보안을 활성화하며 추가 시스템 설정이 필요합니다.

시스템 설정:

머신에서 OpenSearch를 실행하기 전에 성능을 향상시키고 OpenSearch에서 사용할 수 있는 메모리 맵 수를 늘리기 위해 호스트에서 메모리 페이징 및 스와핑 성능을 비활성화해야 합니다.

1. 메모리 페이징 및 스와핑 비활성화:

sudo swapoff -a

2. 호스트의 최대 맵 수를 정의하는 sysctl 구성 파일 편집:

sudo vi /etc/sysctl.conf

3. 최대 맵 수를 권장값인 262144로 설정:

vm.max_map_count=262144

4. 커널 매개변수 다시 로드:

sudo sysctl -p

자세한 정보는 "중요한 시스템 설정"을 참조하세요.

클러스터 설정:

1. 샘플 Compose 파일을 호스트에 다운로드합니다. cURL이나 wget 같은 명령행 유틸리티로 파일을 다운로드하거나, 웹 브라우저를 사용하여 OpenSearch Project documentation-website 저장소에서 docker-compose.yml을 수동으로 복사할 수 있습니다.

cURL 사용:

curl -O https://raw.githubusercontent.com/opensearch-project/documentation-website/3.2/assets/examples/docker-compose.yml

wget 사용:

wget https://raw.githubusercontent.com/opensearch-project/documentation-website/3.2/assets/examples/docker-compose.yml

2. 먼저 커스텀 관리자 비밀번호를 생성합니다. docker-compose.yml 파일과 같은 디렉터리에 .env 파일을 생성(또는 편집)합니다. 이 파일은 Docker Compose가 컨테이너를 시작할 때 자동으로 읽는 환경 변수를 저장합니다. 관리자 비밀번호를 정의하기 위해 다음 줄을 추가합니다:

OPENSEARCH_INITIAL_ADMIN_PASSWORD=<커스텀-관리자-비밀번호>

3. 터미널 애플리케이션에서 다운로드한 docker-compose.yml 파일이 있는 디렉터리로 이동하고 다음 명령을 실행하여 클러스터를 백그라운드 프로세스로 생성하고 시작합니다:

docker compose up -d

4. 다음 명령을 사용하여 컨테이너가 실행 중인지 확인합니다:

docker compose ps

다음과 같은 출력을 볼 수 있습니다:

NAME                    COMMAND                  SERVICE                 STATUS              PORTS
opensearch-dashboards   "./opensearch-dashbo…"   opensearch-dashboards   running             0.0.0.0:5601->5601/tcp
opensearch-node1        "./opensearch-docker…"   opensearch-node1        running             0.0.0.0:9200->9200/tcp, 9300/tcp, 0.0.0.0:9600->9600/tcp, 9650/tcp
opensearch-node2        "./opensearch-docker…"   opensearch-node2        running             9200/tcp, 9300/tcp, 9600/tcp, 9650/tcp

5. OpenSearch가 실행 중인지 확인합니다. 기본 보안 구성이 데모 인증서를 사용하므로 호스트명 확인을 비활성화하기 위해 -k(또는 --insecure)를 사용해야 합니다. 기본 사용자명과 비밀번호(admin:<커스텀-관리자-비밀번호>)를 전달하기 위해 -u를 사용합니다:

curl https://localhost:9200 -ku admin:<커스텀-관리자-비밀번호>

옵션 1과 유사한 응답을 받아야 합니다.

이제 OpenSearch 클러스터를 실행하는 동일한 호스트의 웹 브라우저에서 https://localhost:5601/을 열어 OpenSearch Dashboards를 탐색할 수 있습니다. 기본 사용자명은 admin이고, 기본 비밀번호는 docker-compose.yml 파일의 OPENSEARCH_INITIAL_ADMIN_PASSWORD=<커스텀-관리자-비밀번호> 설정에 지정됩니다.

일반적인 문제들

컨테이너가 시작되지 않거나 예기치 않게 종료되는 경우 다음과 같은 일반적인 문제와 권장 해결책을 검토하세요.

Docker 명령에 관리자 권한이 필요함

사용자를 docker 사용자 그룹에 추가하여 Docker 명령을 sudo 없이 실행할 수 있도록 합니다. 자세한 정보는 Docker의 "Linux용 설치 후 단계"를 참조하세요.

sudo usermod -aG docker $USER

오류 메시지: "max virtual memory areas vm.max_map_count [65530] is too low"

호스트의 vm.max_map_count가 너무 낮으면 OpenSearch가 시작되지 않습니다. 서비스 로그에서 다음 오류를 보면 "중요한 시스템 설정"을 검토하고 vm.max_map_count를 적절히 설정하세요.

opensearch-node1         | ERROR: [1] bootstrap checks failed
opensearch-node1         | [1]: max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]
opensearch-node1         | ERROR: OpenSearch did not exit normally - check the logs at /usr/share/opensearch/logs/opensearch-cluster.log

다른 설치 유형

Docker 외에도 다양한 Linux 배포판과 Windows에서 OpenSearch를 설치할 수 있습니다. 사용 가능한 모든 설치 가이드는 "OpenSearch 설치 및 업그레이드"를 참조하세요.

추가 읽기

OpenSearch Dashboards와 함께 자체 OpenSearch 클러스터를 성공적으로 배포하고 일부 샘플 데이터를 추가했습니다. 이제 구성과 기능에 대해 더 자세히 배울 준비가 되었습니다. 시작할 위치에 대한 몇 가지 권장사항은 다음과 같습니다:

• Security 플러그인에 대해
• OpenSearch 구성
• OpenSearch 플러그인 설치
• OpenSearch Dashboards 빠른 시작

다음 단계

OpenSearch에 요청을 보내는 방법을 배우려면 "OpenSearch와 통신하기"를 참조하세요.