Kubernetes 클러스터 에 MongoDB Search 및 Vector Search를 배포 애플리케이션 내에서 직접 강력한 검색 경험을 빌드 수 있습니다. MongoDB Search 및 Vector Search를 사용하면 기존 텍스트 검색 과 온프레미스 MongoDB database 와 자동으로 동기화 되는 AI 기반 벡터 검색 기능을 모두 빌드 할 수 있습니다. 이렇게 하면 고급 검색 기능을 제공하면서 별도의 시스템 동기화 를 유지할 필요가 없습니다. 자세한 학습 은 다음을 참조하세요.
온프레미스 배포에서 전체 텍스트 및 시맨틱 검색 과 같은 검색 기능을 활성화 하려면 MongoDB 검색 및 벡터 검색 프로세스 (mongot) 배포 이를 MongoDB database 배포서버 (mongod)와 연결해야 합니다. . mongot 배포는 선택 사항이며, 제공하는 검색 기능을 활용하려는 경우에만 필요합니다.
MongoDB 데이터베이스 프로세스(mongod)는 mongot에 대한 모든 검색 쿼리의 프록시 역할을 합니다. mongod 는 쿼리 mongot로 전달하고, 이 쿼리 처리합니다. mongot 는 쿼리 결과를 mongod에 반환한 다음 결과를 사용자에게 전달합니다. mongot와 직접 상호 작용 하지 않습니다.
각 mongot 프로세스 에는 데이터베이스 또는 다른 검색 노드와 공유되지 않는 자체 영구 볼륨이 있습니다. 저장소는 데이터베이스 에서 지속적으로 제공되는 데이터로 구축된 인덱스를 유지 관리하는 데 사용됩니다. 인덱스 정의(메타데이터)는 데이터베이스 자체에 저장됩니다.
mongot 는 다음 조치를 수행합니다.
인덱스 관리합니다.
mongot는 데이터베이스 의 인덱스 정의를 업데이트하는 역할을 합니다.데이터베이스 에서 데이터를 가져옵니다.
mongot노드는 데이터베이스 에서 실시간 인덱스를 업데이트 위해 데이터베이스 에 대한 영구 연결을 설정합니다.검색 쿼리를 처리합니다.
mongod가$search,$searchMeta또는$vectorSearch쿼리 수신하면 쿼리mongot노드 중 하나로 전달합니다. 쿼리 수신한mongot는 쿼리 처리하고 데이터를 집계한 다음 결과를mongod에 반환하고, 이를 사용자에게 전달합니다.
mongot 구성 요소는 단일 MongoDB 복제본 세트 와 긴밀하게 결합되어 있으며 여러 데이터베이스 또는 복제본 세트에서 공유할 수 없습니다. 즉, 복제본 세트 배포서버 자체 전용 검색 노드가 있습니다.
mongot 와 mongod 간의 네트워크 연결은 양방향으로 진행됩니다.
mongot인덱스를 빌드 하고 쿼리를 실행 데 사용되는 데이터를 소싱하기 위해 복제본 세트 에 대한 연결을 설정합니다.mongodmongot에 연결하여 인덱스 관리 및 데이터 쿼리와 같은 검색 관련 작업을 전달합니다.
MongoDB Search 및 Vector Search 배포
Kubernetes Operator의 유무에 관계없이 검색 배포서버 아키텍처 간에는 많은 차이점이 없습니다. Kubernetes Operator는 특히 데이터베이스 Kubernetes Operator에 의해 managed 경우, 완전히 작동하는 검색 노드를 배포 데 필요한 단계를 간소화합니다.
MongoDBSearch 을(를) 배포 하려면 Kubernetes Operator가 선택하여 mongot 파드 배포를 시작하고 spec에 지정된 영구 저장 요청하는 사용자 지정 리소스(CR)를 적용 . Kubernetes Operator를 사용하여 배포된 MongoDB Search 및 Vector Search는 동일한 Kubernetes 클러스터 내부 또는 완전히 독립적인 외부 MongoDB database 내에 Kubernetes Operator가 배포한 MongoDB 복제본 세트 대상으로 할 수 있습니다. 사용할 mongot 를 배포 하고 구성하는 방법을 학습 :
Kubernetes 의 MongoDB 복제본 세트, 설치 및 MongoDB 엔터프라이즈 로 검색 사용을 참조하세요.
외부 MongoDB 복제본 세트, 외부 MongoDB 엔터프라이즈에서 MongoDB Search 설치 및 사용 및 Vector Search를 참조하세요.
전제 조건
MongoDB 엔터프라이즈 배포서버 서버에서 MongoDB Search 및 Vector Search를 활용하려면 다음이 필요합니다.
완전한 기능을 갖춘 MongoDB 8.0.10+ 다음 방법 중 하나로 복제본 세트 배포합니다.
Kubernetes Operator를 사용하는 Kubernetes 클러스터 내부
Kubernetes 클러스터 외부
Cloud Manager 또는 MongoDB Ops Manager 인스턴스
구성 작업
다음 표는 Kubernetes Operator가 자동으로 수행하는 구성 작업과 Kubernetes 에 MongoDB Search 및 Vector Search를 성공적으로 배포 하고 Kubernetes 의 MongoDB 복제본 세트 또는 외부 MongoDB 복제본 세트 에 연결하기 위해 수행해야 하는 조치를 보여줍니다.
작업 | (Inside Kubernetes) Performed by | (External MongoDB) Performed by |
|---|---|---|
Kubernetes 내에 MongoDB Ops Manager 배포 | 쿠버네티스 오퍼레이터 | 쿠버네티스 오퍼레이터 |
Kubernetes 외부에 Cloud Manager 또는 MongoDB Ops Manager 배포 | you | you |
MongoDB 복제본 세트 배포 | 쿠버네티스 오퍼레이터 | you |
| you | you |
MongoDB 복제본 세트 에 연결 문자열 제공 | 쿠버네티스 오퍼레이터 | you |
| 쿠버네티스 오퍼레이터 | 쿠버네티스 오퍼레이터 |
각 | 쿠버네티스 오퍼레이터 | you |
8.2이하의 MongoDB 버전에서 | 쿠버네티스 오퍼레이터 | you |
| MongoDBUser 리소스 적용하여 Kubernetes Operator와 사용자 | you |
검색 쿼리 데 필요한 권한이 있는 사용자로 MongoDB 복제본 세트 구성합니다. | you | you |
MongoDB Search 및 Vector Search 인덱스 생성 | you | you |
각 | 필요하지 않음 | you |
| 필요하지 않음 | you |
다음 다이어그램은 Kubernetes 클러스터 에 MongoDB 엔터프라이즈 복제본 세트 있는 단일 MongoDB Search 및 Vector Search 인스턴스 의 배포서버 아키텍처를 보여줍니다.
다음 다이어그램은 Kubernetes Operator가 MongoDB 엔터프라이즈 복제본 세트 사용하여 MongoDB Search 및 Vector Search를 위해 Kubernetes 클러스터 에 배포하는 구성 요소를 보여줍니다.
mongot 및 mongod 프로세스가 모두 Kubernetes 클러스터 내에 배포되면 Kubernetes Operator는 두 프로세스에 대한 구성을 자동으로 수행합니다. 구체적으로 Kubernetes Operator는 다음 작업을 수행합니다.
spec.source.mongodbResourceRef를 사용하여MongoDBSearch에서 참조하는 MongoDB CR 을 찾거나MongoDBSearch와 이름이 같은 MongoDB CR 을 찾아 명명 규칙에 따라 찾습니다.YAML 파일 에
mongot구성을 생성하고<MongoDBSearch.metadata.name>-search-config이라는 구성 맵에 저장합니다.구성 맵은 검색 파드에 의해 마운트되고 YAML 구성은 스타트업 시
mongot의 프로세스에서 사용됩니다. 생성된 YAML 에는 복제본 세트에 연결하는 방법, TLS 설정 등에 대한 모든 정보가 포함되어 있습니다.spec.persistence및spec.resourceRequirements설정에 따라 구성된 저장 및 리소스 요구 사항을 사용하여 이름이<MongoDBSearch.metadata.name>-search인 MongoDB Search 및 Vector Search 스테이트풀(Stateful) 설정을 CR에 배포합니다.mongot 호스트의 호스트 이름 및 포트 번호를 포함하여 필요한
setParameter옵션을 추가하여 모든mongod프로세스 의 구성을 업데이트합니다. MongoDB 복제본 세트 멤버의 호스트 이름 및 포트 번호를 포함하여 필요한setParameter옵션.v8.2 이전 MongoDB 버전의 경우
mongot프로세스 에 필요한 모든 권한이 있는searchCoordinator사용자 지정 역할 생성합니다. MongoDB 8.2부터searchCoordinator는 내장 역할 입니다.
다음 조치를 수행해야 합니다.
MongoDBUser사용자 지정 리소스 사용하여 복제본 세트 에 사용자를 만듭니다.mongot는 이 사용자의 자격 증명 사용하여 복제본 세트 에 연결하여 데이터를 소싱합니다.사용자 이름은 임의적이지만(예시에서는
search-sync-source-user사용),searchCoordinator역할 설정하다 있어야 합니다.이 사용자의 사용자 이름 과 비밀번호는 각각
MongoDBSearch.spec.source.username및MongoDBSearch.spec.source.passwordSecretRef로 전달됩니다.비밀번호 시크릿은
MongoDBUser사양(MongoDBUser.spec.source.passwordSecretKeyRef)을 생성하는 데 사용된 사용자 비밀번호가 포함된 동일한 시크릿을 참조할 수 있습니다.
MongoDBSearch사용자 지정 리소스 구성하고 적용 .
mongot 프로세스의 CR 설정에 대해 자세히 학습하려면 MongoDB 검색 및 벡터 검색 설정을 참조하세요.
다음 다이어그램은 외부 MongoDB 엔터프라이즈 복제본 세트 사용하여 Kubernetes 클러스터 에서 MongoDB Search 및 Vector Search의 배포서버 아키텍처를 보여줍니다.
다음 다이어그램은 Kubernetes Operator가 MongoDB 검색 및 벡터 검색을 위해 Kubernetes 클러스터 에 배포하는 구성 요소를 보여줍니다.
Kubernetes 외부에 MongoDB deployment 있는 경우 MongoDB Search 및 Vector Search를 활용하려면 Kubernetes Operator를 사용하여 mongot 를 배포 하고 몇 가지 단계를 수동으로 수행해야 합니다. Kubernetes Operator는 검색 파드의 구성을 처리합니다. 그러나 MongoDB 복제본 세트 Kubernetes 외부에 있는 경우 MongoDB 노드와 네트워킹을 재구성해야 합니다.
다음과 같은 수동 구성에 대한 책임은 사용자에게 있습니다.
외부 MongoDB 구성
외부 복제본 세트 의 모든
mongod프로세스 에서setParameter를 사용하여 다음 매개변수를 구성합니다. 구성할 때<search-service-hostname>:27027를MongoDBSearch서비스의 확인 가능한 실제 호스트 이름 및 포트로 바꾸세요.setParameter: mongotHost: "<search-service-hostname>:27027" searchIndexManagementHostAndPort: "<search-service-hostname>:27027" skipAuthenticationToSearchIndexManagementServer: false searchTLSMode: "disabled" # or "requireTLS" for TLS deployments ((
<) 8.2 미만의 MongoDB 버전에만 해당) 필요한 모든 권한이 포함된searchCoordinator사용자 지정 역할 만듭니다.MongoDB 8.2+에서는
searchCoordinator가 내장 역할 이므로 이 단계를 건너뛸 수 있습니다.검색 동기화 프로세스 위해 외부 복제본 세트 에서 사용자를 생성합니다. 이 사용자는
searchCoordinator역할 있어야 합니다.- userName: "search-sync-source" password: "<your-search-sync-password>" database: "admin" roles: - role: "searchCoordinator" db: "admin"
Kubernetes 구성
외부 MongoDB 호스트를 가리키는 가 포함된
MongoDBSearchCR을 구성하고 적용 .spec.source.external검색 동기화 사용자의 비밀번호에 대한 Kubernetes 시크릿을 생성하십시오.
apiVersion: v1 kind: Secret metadata: name: search-sync-source-password stringData: password: "your-search-sync-password" 외부 MongoDB 복제본 세트 에서 사용하는 키 파일에 지정된 것과 동일한 키를 포함하는 키 파일 시크릿을 생성합니다.
외부 MongoDB 와 검색 파드 간의 양방향 연결이 보장되도록 네트워킹 및 DNS를 구성합니다. 외부 MongoDB 환경에서 검색 서비스 호스트 이름(
<search-service-hostname>)을 확인할 수 있어야 합니다.
외부 mongod 프로세스에 연결하기 위한 mongot 프로세스의 CR 설정에 대해 자세히 학습하려면 MongoDB 검색 및 벡터 검색 설정을 참조하세요.
보안
다음 이미지는 mongot 프로세스 에 대한 보안 구성을 보여줍니다. MongoDB 서버 Kubernetes 클러스터 내부에 있는 경우, Kubernetes Operator는 MongoDB Search 및 Vector Search에 대한 키 파일 인증 자동으로 설정합니다. MongoDB 서버 외부 서버인 경우, 복제본 세트의 키 파일 자격 증명이 포함된 Kubernetes 시크릿을 생성하고 이를 MongoDBSearch CR에서 참조해야 합니다.
인증
mongod에 연결할 때 mongot 는 자신을 데이터베이스 사용자로 인증합니다. MongoDB Search 및 Vector Search를 배포할 때는 데이터베이스 사용자를 생성해야 합니다. MongoDBSearch CR의 spec.source.username 및 spec.source.passwordSecretRef 필드를 채워 Kubernetes 시크릿에 저장된 사용자 자격 증명 mongot 에 전달해야 합니다.
mongod에서 연결을 수락할 때 mongot 는 MongoDB 복제본 세트 멤버 내부 인증 과 유사하게 키 파일을 사용한 내부 인증 사용하여 원격 요청 인증합니다. 동일한 Kubernetes 클러스터 에서 MongoDB 리소스 인덱스 하도록 구성된 경우, Kubernetes Operator는 MongoDBSearch에 대한 키 파일 인증 자동으로 설정합니다. MongoDB 복제본 세트 Kubernetes 외부에 배포된 경우 복제본 세트의 키 파일 자격 증명이 포함된 Kubernetes 시크릿을 생성하고 MongoDBSearch.spec.source.external.keyfileSecretRef 필드 에서 이를 참조해야 합니다.
전송 계층 보안
MongoDBSearch 은(는) TLS를 사용하여 전송 중인 데이터와 자격 증명 보호할 수 있습니다. 인덱스 관리 명령 및 검색 쿼리의 경우 (빈 객체{}) spec.security.tls 필드를 지정하고 spec.security.tls.certificateKeySecretRef 필드의 Kubernetes 시크릿에 TLS 인증서를 제공합니다. 이 TLS 인증서는 MongoDB 복제본 세트 사용하는 CA 인증서를 발급한 동일한 CA에서 발급하고 서명해야 합니다.
Kubernetes Operator에서 MongoDBSearch 및 MongoDB 를 모두 배포하는 경우 기본 mongot 및 mongod 구성은 대부분 Kubernetes Operator 자체에서 처리됩니다. MongoDB 복제본 세트 Kubernetes 외부에 배포되는 경우, .spec.source.external.tls 필드 mongod 와 동일한 CA 인증서가 포함된 Kubernetes 시크릿으로 채워져야 하며, mongod 구성 자체에 searchTLSMode 매개변수가 다음으로 설정하다 있어야 합니다. requireTLS.