Qdrant Cloud 클러스터 접근

Qdrant Cloud 클러스터 접근 (cloud-cluster-access)

클러스터를 만들고 API 키를 설정했다면, 이제 그 클러스터에 어떻게 접근할지 정리해 볼게요. Qdrant Cloud 클러스터에는 Cluster UI, REST API, gRPC API 세 가지 방식으로 접근할 수 있어요.

출처: Qdrant 공식 문서 — cloud/cluster-access

Cluster UI

Cluster UI는 Qdrant Cloud Console의 Cluster Details 페이지에서 접근할 수 있어요. 클라우드 사용자가 read:cluster_data 또는 write:cluster_data 권한을 갖고 있으면 클러스터 인증이 자동으로 처리돼요. 권한이 없으면 클러스터에 접근할 때 API 키를 입력하라는 안내가 나와요.

Overview 탭에는 Qdrant 튜토리얼과 샘플 데이터셋을 살펴볼 수 있는 직접 링크도 함께 있어요.

API

REST API는 클러스터 엔드포인트의 **포트 6333**에서, gRPC API는 **포트 6334**에서 노출돼요. 클러스터 엔드포인트에 접근하면 트래픽이 클러스터 안의 정상(healthy) Qdrant 노드 전체에 자동으로 로드밸런싱돼요. 몇 가지 특수한 **노드 전용 엔드포인트(Node specific endpoints)**를 제외한 모든 작업에서는 클러스터 엔드포인트를 쓰는 걸 권장해요. 어느 노드에 도착하는지는 상관없어요. 모든 노드가 모든 검색·쓰기 요청을 처리할 수 있거든요.

Qdrant Cloud API와 상호작용하는 방법에 대한 자세한 내용은 API 레퍼런스와 공식 클라이언트 라이브러리를 참고하면 돼요.

노드 전용 엔드포인트 (Node Specific Endpoints)

모든 정상 노드에 요청을 분산하는 클러스터 엔드포인트와 별개로, 클러스터 안의 각 노드도 자기만의 엔드포인트를 갖고 있어요. 이 엔드포인트는 주로 모니터링이나 수동 샤드 관리에 유용해요. 노드 전용 엔드포인트는 Qdrant Cloud Console의 클러스터 상세 페이지에서 확인할 수 있어요.

IP 범위로 클러스터 접근 제한 (Restricting Cluster Access by IP Range)

허용된 IP 범위를 지정해서 클러스터에 대한 접근을 제한할 수 있어요. 이렇게 하면 지정된 IP 범위에서 접속하는 클라이언트만 클러스터에 접근할 수 있어요. 자세한 내용은 Client IP Restrictions 문서를 참고하세요.

더 알아보기 (Learn more)