설치

설치 (installation)

Qdrant를 처음 설치할 때 어떤 하드웨어가 필요한지, 어떤 포트를 열어야 하는지, 그리고 개발 환경과 운영(프로덕션) 환경에서 각각 어떻게 설치하는지 정리해 둔 문서예요. 실제로 설치하기 전에 이 페이지를 먼저 훑어보면 어디에 초점을 맞춰야 할지 감이 잡힐 거예요.

출처: Qdrant 공식문서

설치 요구사항 (Installation requirements)

CPU와 메모리

CPU와 RAM의 적정 크기는 다음 요소에 따라 달라져요.

  • 벡터의 개수
  • 벡터의 차원
  • 페이로드(Payload)와 그 인덱스
  • 스토리지
  • 복제(Replication)
  • 양자화(Quantization)를 어떻게 구성하는지

즉, "이 정도 벡터면 이 정도 RAM"이라고 단정하기보다, 데이터 규모와 구성 방식을 먼저 정해야 정확한 용량을 계산할 수 있어요.

스토리지

벡터를 로컬 디스크에 내려서 보관한다면, SSD 또는 NVMe 같은 솔리드 스테이트 드라이브를 권장해요. 특히 Windows에서 Docker/WSL을 쓰면서 마운트(mount)를 사용하면 파일시스템 문제로 데이터가 손실될 수 있다는 점이 알려져 있어요. 관련 내용은 트러블슈팅 문서에서 확인할 수 있습니다.

네트워킹

Qdrant가 쓰는 포트는 다음과 같아요.

  • 6333 — HTTP API용. 모니터링 헬스 및 메트릭 엔드포인트도 이 포트를 사용해요.
  • 6334 — gRPC API용.
  • 6335 — 분산 배포용.

프로덕션 (Production)

Qdrant Cloud

Qdrant Cloud를 이용하면 완전 관리형 Qdrant 데이터베이스를 구성할 수 있어요. 수평·수직 스케일링, 원클릭 설치와 업그레이드, 모니터링, 로깅, 그리고 백업과 재해 복구까지 제공하죠.

Kubernetes

Helm 차트로 Qdrant를 분산 설정으로 배포하는 것도 가능해요. 다만 무중단 업그레이드, 스케일 업/다운, 모니터링, 로깅, 백업·재해 복구 같은 기능은 Qdrant Cloud나 Qdrant Private Cloud Enterprise Operator만큼의 수준을 갖추진 못해요.

Docker와 Docker Compose

Docker 배포를 고려한다면 다음 두 가지를 함께 염두에 두는 게 좋아요.

개발 (Development)

Docker

아래 명령에서 $(pwd)/path/to/data 부분을 사용자의 Docker 설정에 맞게 수정한 뒤 실행하면 돼요.

docker run -p 6333:6333 \
     -v $(pwd)/path/to/data:/qdrant/storage \
     qdrant/qdrant

이 명령으로 기본 설정의 Qdrant 인스턴스를 시작해요. 모든 데이터는 ./path/to/data 디렉터리에 저장됩니다.

기본적으로 Qdrant는 6333 포트를 사용하기 때문에, localhost:6333에서 환영 메시지를 볼 수 있어요.

Qdrant 구성을 바꾸려면 프로덕션 설정 파일을 덮어쓰는 방식으로 진행할 수 있어요.

docker run -p 6333:6333 \
     -v $(pwd)/path/to/data:/qdrant/storage \
     -v $(pwd)/path/to/custom_config.yaml:/qdrant/config/production.yaml \
     qdrant/qdrant

또는 자신만의 custom_config.yaml 설정 파일을 직접 지정하는 방법도 있어요.

docker run -p 6333:6333 \
     -v $(pwd)/path/to/data:/qdrant/storage \
     -v $(pwd)/path/to/custom_config.yaml:/qdrant/config/custom_config.yaml \
     qdrant/qdrant \
     ./qdrant --config-path config/custom_config.yaml

더 알아보기 (Learn more)