Qdrant 서버 준비하기

AI DB 설정에서 드라이버로 Qdrant를 선택하려면 먼저 접속할 수 있는 Qdrant 서버가 있어야 합니다. SetFN이 Qdrant 서버를 함께 설치해 주지는 않으므로, Docker로 직접 준비하는 방법을 안내합니다.

시작하기 전에

• Qdrant 서버를 올릴 Linux(Ubuntu) 환경과 관리자(sudo) 권한이 필요합니다.
• 해당 환경에 Docker가 설치되어 있지 않다면 먼저 설치합니다.
• SetFN 서버가 이 Qdrant 서버에 네트워크로 접근할 수 있어야 합니다.

Docker 설치하기

Ubuntu 기준 Docker 공식 설치 절차입니다. 이미 Docker가 설치되어 있다면 이 단계는 건너뜁니다.

1. 패키지 색인 갱신 및 필요한 패키지 설치

sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

2. Docker 저장소를 Apt 소스에 추가

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

3. Docker 패키지 설치

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Qdrant 컨테이너 실행하기

1. docker-compose.yml 파일 만들기

Qdrant를 실행할 폴더에 docker-compose.yml 파일을 만들고 다음 내용을 입력합니다.

services:
  qdrant:
    image: qdrant/qdrant:latest
    container_name: qdrant
    restart: unless-stopped
    ports:
      - "6333:6333"
      - "6334:6334"
    volumes:
      - ./qdrant_storage:/qdrant/storage

2. 컨테이너 실행

같은 폴더에서 컨테이너를 실행합니다.

sudo docker compose up -d

• image: 사용할 Qdrant 이미지와 버전입니다. latest는 컨테이너를 다시 받을 때마다 최신 버전으로 바뀌므로, 운영 환경에서는 Qdrant 릴리스에서 특정 버전(예: qdrant/qdrant:v1.12.4)으로 고정하는 것을 권장합니다. 사내 레지스트리를 미러로 쓴다면 이 경로를 그 주소로 바꿀 수 있습니다.
• container_name, ./qdrant_storage: 컨테이너 이름과 데이터 저장 경로는 예시일 뿐이며 원하는 값으로 바꿔도 됩니다.
• 6333: REST API(HTTP) 포트입니다.
• 6334: gRPC 포트입니다. 바이너리 프로토콜(protobuf)을 사용해 대량 업서트나 배치 검색처럼 처리량이 큰 작업에서 REST API보다 빠릅니다. SetFN은 AI DB 설정에서 gRPC 연결을 지원하며, 검색과 벡터 저장에 gRPC를 우선 사용하도록 권장합니다.

SetFN에 연결하기

AI DB 설정의 로컬 AI DB 구성에서 다음 항목을 입력하고 저장 버튼을 누릅니다.

저장 후 로컬 AI DB 운영 현황의 연결 상태가 연결됨으로 바뀌고 벡터 스토어가 Qdrant로 표시되면 정상적으로 연결된 것입니다.

관련 문서

• AI DB 설정
• 지식 인덱싱