하이브리드 클라우드에서 클러스터 만들기

하이브리드 클라우드에서 클러스터 만들기 (hybrid-cloud-hybrid-cloud-cluster-creation)

하이브리드 클라우드 환경이 만들어지면, 그 환경 안에서 Qdrant 클러스터를 만드는 일반적인 과정을 그대로 따르면 돼요. 이 페이지에는 프로덕션에 적합한 클러스터를 만드는 데 도움이 되는 추가 정보도 담겨 있어요.

대상으로 하이브리드 클라우드 환경을 선택해야 해요.

참고로 'Kubernetes Configuration' 섹션에서 추가로 설정할 수 있는 항목들은 다음과 같아요.

Qdrant 데이터베이스 파드에 대한 NodeSelector
Qdrant 데이터베이스 파드에 대한 Toleration
Qdrant 데이터베이스 파드에 대한 TopologySpreadConstraints
Qdrant 데이터베이스 파드에 대한 추가 라벨
Qdrant 데이터베이스 서비스에 대한 서비스 유형과 어노테이션

이 설정들은 클러스터를 만든 뒤에도 클러스터 상세 페이지에서 변경할 수 있어요.

스케줄링 구성 (Scheduling Configuration)

클러스터를 만들거나 편집할 때 Kubernetes 클러스터의 파드-노드 스케줄링을 구성할 수 있어요. 이 기능은 Qdrant 데이터베이스가 전용 노드에서 실행되도록 보장할 때 유용해요. 필요한 nodeSelector, toleration, topologySpreadConstraints는 클러스터 생성 중 'Kubernetes Configuration' 섹션에서, 또는 클러스터 상세 페이지에서 구성할 수 있어요. 자세한 내용은 '스케줄링 파드를 노드로' 문서를 참고하세요.

Qdrant 클러스터에 대한 인증

기본적으로 하이브리드 클라우드의 클러스터는 Kubernetes 네트워크 안의 Kubernetes ClusterIP 서비스로만 노출되고 외부에서는 접근할 수 없어요. 또 API 키도 구성되어 있지 않아요. 데이터베이스를 내부 또는 외부로 노출하려면 반드시 API 키를 구성해야 해요.

하이브리드 클라우드에서 인증 정보는 Kubernetes secrets로 제공돼요.

Qdrant 클러스터 상세 페이지의 'Configuration' 섹션에서 Qdrant 클러스터에 대한 인증을 구성할 수 있어요. 여기서 API 키나 읽기 전용 API 키로 사용할 Kubernetes secret의 이름과 키를 구성할 수 있어요.

secret을 만드는 한 가지 방법은 kubectl을 사용하는 거예요.

kubectl create secret generic qdrant-api-key --from-literal=api-key=your-secret-api-key --namespace the-qdrant-namespace

결과로 만들어지는 secret은 다음과 같은 형태가 돼요.

apiVersion: v1
data:
  api-key: ...
kind: Secret
metadata:
  name: qdrant-api-key
  namespace: the-qdrant-namespace
type: kubernetes.io/generic

이 명령에서 secret 이름은 qdrant-api-key, 키는 api-key가 돼요. secret을 다시 확인하고 싶다면 kubectl로 이렇게 읽을 수도 있어요.

kubectl get secret qdrant-api-key -o jsonpath="{.data.api-key}" --namespace the-qdrant-namespace | base64 --decode

API 키 secret을 구성한 뒤에는 Qdrant 클러스터 UI에서 세분화된 접근 제어가 적용된 JWT를 만들 수 있어요. 자세한 내용은 'JWT를 이용한 세분화된 접근 제어' 문서를 참고하세요.

동영상 보기

이 튜토리얼에서는 그래미 브라우저? — Kubernetes 클러스터 바깥의 외부 애플리케이션이나 사용자에게 Qdrant 하이브리드 클라우드에서 실행 중인 Qdrant 데이터베이스 클러스터를 노출하는 단계를 하나씩 안내해요. 클러스터를 노출하도록 구성하는 방법을 배울 수 있어요.

출처: Qdrant 공식문서