对于 AI 代理：可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

安装和使用MongoDB Search 和 Vector Search With external MongoDB Enterprise Edition

您可以使用Kubernetes Operator 在Kubernetes集群上部署MongoDB Search 和 Vector Search，与外部MongoDB Enterprise Edition v8.0.10 或更高版本的服务器一起运行。此过程演示如何在Kubernetes集群中部署和配置 mongot进程，以使用新的或现有的外部副本集部署。

先决条件

要部署MongoDB Search 和 Vector Search，您必须具备以下条件：

  • 一个运行的Kubernetes集群，且本地可用 kubeconfig。

  • Kubernetes命令行工具 kubectl，配置为与集群通信。

  • Helm（ Kubernetes的包管理器），用于安装Kubernetes Operator。

  • Bash v5.1 或更高版本，用于运行本教程中的命令。

  • 运行8.0.10 或更高版本的MongoDB Enterprise Edition副本集，用于存储数据。

    要学习；了解有关部署MongoDB Enterprise 的更多信息，请参阅部署和配置MongoDB数据库资源。

  • 运行的MongoDB Cloud Manager或MongoDB Ops Manager ，用于管理MongoDB任务。

开始之前

在使用Kubernetes Operator 安装MongoDB Search 和 Vector Search 之前，您必须执行以下操作：

为MongoDB Search 和 Vector Search 配置Cloud Manager或MongoDB Ops Manager参数

登录到Cloud Manager或MongoDB Ops Manager用户界面并执行以下步骤，为MongoDB Search 和 Vector Search 配置Cloud Manager或MongoDB Ops Manager 。

1

Go 到您的 Cloud Manager 或 Ops Manager Deployment 页面。

  1. 登录MongoDB Cloud Manager或MongoDB Ops Manager。

  2. 单击 Deployment 标签页。

  3. 选择要修改的集群。

2

修改Cloud Manager或MongoDB Ops Manager部署配置。

  1. 单击 Modify 按钮打开部署配置编辑器。

  2. 在 Process Configuration（添加特性和功能）部分下，单击 Advanced Configuration Options（权限）。

  3. 单击 Add Option 按钮，然后从下拉列表中选择 setParameter Startup Option。

  4. 添加名称和值后，单击 Add，在字段中逐个添加以下参数：

    Parameter
    值

    mongotHost

    您的搜索主机名和端口。示例：search-node1.example.com:27017。

    searchIndexManagementHostAndPort

    您的搜索主机名和端口。示例：search-node1.example.com:27017。

    skipAuthenticationToSearchIndexManagementServer

    false

    searchTLSMode

    您配置的 TLS模式。示例，如果 mongot进程配置为接受 TLS 连接，则为 preferTLS。

3

查看并部署更改。

  1. 单击 Review & Deploy 按钮。

  2. 查看并确认以应用更改。

    Cloud Manager或MongoDB Ops Manager对副本集执行滚动重启以应用新配置。

为MongoDB Search 和 Vector Search 配置Cloud Manager或MongoDB Ops Manager用户

您必须创建具有 searchCoordinator角色的用户。在MongoDB 8.2 及更高版本中，searchCoordinator 是一个内置角色。您必须创建一个用户并为该用户分配角色。对于 8.2 和 8.0.10 之前或更高版本的MongoDB版本，您必须在创建用户之前手动创建角色并分配权限。选择与您运行的MongoDB版本对应的标签页，创建具有 searchCoordinator角色的用户。

设置您的环境

准备环境，以便在终端中运行本教程中的示例代码。

1

必填。设置环境变量。

要设立用于此过程后续步骤的环境变量，请复制以下内容，设立环境变量的值，然后加载环境变量：

export K8S_CTX="<your kubernetes context here>"
export MDB_NS="mongodb"
export MDB_VERSION="8.0.10"
export MDB_ADMIN_USER_PASSWORD="admin-user-password-CHANGE-ME"export MDB_USER_PASSWORD="mdb-user-password-CHANGE-ME"export MDB_SEARCH_SYNC_USER_PASSWORD="search-sync-user-password-CHANGE-ME"
export MDB_SEARCH_HOSTNAME="mdbs-search"
# External MongoDB replica set members - REPLACE THESE VALUES with your actual external MongoDB hosts# In production, replace with your actual external MongoDB replica set membersexport MDB_EXTERNAL_HOST_0="mdbc-rs-0.mdbc-rs-svc.${MDB_NS}.svc.cluster.local:27017"export MDB_EXTERNAL_HOST_1="mdbc-rs-1.mdbc-rs-svc.${MDB_NS}.svc.cluster.local:27017"export MDB_EXTERNAL_HOST_2="mdbc-rs-2.mdbc-rs-svc.${MDB_NS}.svc.cluster.local:27017"
# REPLACE with your external MongoDB keyfile secret nameexport MDB_EXTERNAL_KEYFILE_SECRET_NAME="mdbc-rs-keyfile"
# REPLACE with the actual keyfile content from your external MongoDB replica set# For testing, this will be automatically generated by the MongoDB Community resourceexport MDB_EXTERNAL_KEYFILE_CONTENT="your-mongodb-keyfile-content-CHANGE-ME"
# REPLACE with your actual external MongoDB replica set nameexport MDB_EXTERNAL_REPLICA_SET_NAME="mdbc-rs"
export OPERATOR_HELM_CHART="mongodb/mongodb-kubernetes"export OPERATOR_ADDITIONAL_HELM_VALUES=""
export MDB_CONNECTION_STRING="mongodb://mdb-user:${MDB_USER_PASSWORD}@${MDB_EXTERNAL_HOST_0}/?replicaSet=${MDB_EXTERNAL_REPLICA_SET_NAME}"
2

有条件。添加MongoDB Helm存储库。

Helm 可自动部署和管理Kubernetes上的MongoDB实例。如果您已经添加了包含用于安装Kubernetes Operator 操作符 的Helm图表的Helm存储库，请跳过此步骤。否则，请添加Helm存储库。

要添加、复制、粘贴并运行以下命令：

helm repo add mongodb https://mongodb.github.io/helm-chartshelm repo update mongodbhelm search repo mongodb/mongodb-kubernetes
3

有条件。为Kubernetes Operator 安装MongoDB控制器。

Kubernetes Operator 监视 MongoDB、MongoDBOpsManager 和 MongoDBSearch 自定义资源，并管理MongoDB部署的生命周期。如果您已经安装了MongoDB Controllers for Kubernetes Operator，请跳过此步骤。否则，请从您在上一步中添加的Helm存储库安装MongoDB Controllers for Kubernetes Operator。

要在 mongodb命名空间中安装MongoDB Controllers for Kubernetes Operator，请复制、粘贴并运行以下命令：

helm upgrade --install --debug --kube-context "${K8S_CTX}" \  --create-namespace \  --namespace="${MDB_NS}" \  mongodb-kubernetes \  ${OPERATOR_ADDITIONAL_HELM_VALUES:+--set ${OPERATOR_ADDITIONAL_HELM_VALUES}} \  "${OPERATOR_HELM_CHART}"

前面的命令会在 mongodb命名空间中安装Kubernetes Operator；如果该命名空间不存在，则会创建该命名空间。安装后， Kubernetes Operator 会监视 MongoDBSearch 自定义资源并管理MongoDB Search 和 Vector Search 部署的生命周期。

安装MongoDB Search 和 Vector Search

1

必需。创建并加载MongoDB用户密钥。

mongot进程需要身份验证凭证才能连接到外部MongoDB 部署，从而创建搜索索引和运行搜索查询。此步骤将创建以下Kubernetes密钥：

  • mdb-admin-user-password — MongoDB管理员的凭证。

  • mdb-user-password — 经授权执行搜索查询的用户的凭证。

  • mdbc-rs-search-sync-source-password — 专用搜索用户的凭证，由 mongot进程在内部用于同步数据和管理索引。

Kubernetes Operator 将这些密钥挂载到MongoDB Pod 中。

要创建密钥，请在计划部署MongoDB Search 和 Vector Search 的命名空间中复制、粘贴并运行以下命令：

kubectl --context "${K8S_CTX}" --namespace "${MDB_NS}" \  create secret generic mdb-admin-user-password \  --from-literal=password="${MDB_ADMIN_USER_PASSWORD}"
kubectl --context "${K8S_CTX}" --namespace "${MDB_NS}" \  create secret generic mdbc-rs-search-sync-source-password \  --from-literal=password="${MDB_SEARCH_SYNC_USER_PASSWORD}"
kubectl --context "${K8S_CTX}" --namespace "${MDB_NS}" \  create secret generic mdb-user-password \  --from-literal=password="${MDB_USER_PASSWORD}"
2

必填。部署密钥文件密钥以用于连接到mongod 。

为了对来自外部MongoDB 的连接进行身份验证，mongot进程使用的密钥文件与外部MongoDB副本集用于副本集之间的内部身份验证的密钥文件相同。

要创建包含来自外部MongoDB 的密钥文件内容的Kubernetes密钥，请复制、粘贴并运行以下命令：

kubectl --context "${K8S_CTX}" --namespace "${MDB_NS}" \  create secret generic "${MDB_EXTERNAL_KEYFILE_SECRET_NAME}" \  --from-literal=keyfile="${MDB_EXTERNAL_KEYFILE_CONTENT}"
3

必需。为MongoDB Search 和 Vector Search 创建并部署资源。

您可以部署一个搜索节点实例，而无需任何负载均衡。要部署，请完成以下步骤：

  1. 创建名为 mdbs 的 MongoDBSearch 自定义资源。

    此资源包含以下内容：

    spec.source.external.hostAndPorts

    外部MongoDB副本集节点列表。

    spec.source.external.keyfileSecretRef

    外部副本集成员使用的密钥文件密钥。

    spec.source.username

    搜索同步用户用户名。

    spec.source.passwordSecretRef

    搜索同步用户密码。

    spec.resourceRequirements

    搜索容器的 CPU 和内存资源要求。

    要学习；了解有关此自定义资源中设置的更多信息，请参阅MongoDB搜索和向量搜索设置。

    kubectl apply --context "${K8S_CTX}" -n "${MDB_NS}" -f - <<EOFapiVersion: mongodb.com/v1kind: MongoDBSearchmetadata:  name: mdbsspec:  source:    external:      hostAndPorts:        - ${MDB_EXTERNAL_HOST_0}        - ${MDB_EXTERNAL_HOST_1}        - ${MDB_EXTERNAL_HOST_2}      keyfileSecretRef:        name: ${MDB_EXTERNAL_KEYFILE_SECRET_NAME}        key: keyfile    username: search-sync-source    passwordSecretRef:      name: mdbc-rs-search-sync-source-password      key: password  resourceRequirements:    limits:      cpu: "3"      memory: 5Gi    requests:      cpu: "2"      memory: 3GiEOF

  2. 等待 MongoDBSearch资源部署完成。

    当您应用MongoDBSearch 自定义资源时， Kubernetes 操作符开始部署搜索节点 (pod)。此步骤会暂停执行，直到 mdbs 资源的状态阶段为 Running，这表示MongoDB Search StatefulSet 处于可操作状态。

    echo "Waiting for MongoDBSearch resource to reach Running phase..."kubectl --context "${K8S_CTX}" -n "${MDB_NS}" wait \  --for=jsonpath='{.status.phase}'=Running mdbs/mdbs --timeout=300s
4

必需。为MongoDB Search 和 Vector Search 配置外部访问权限。

启用外部MongoDB实例能够连接到搜索服务，您必须为MongoDB Search 和 Vector Search 配置外部访问权限。您可以创建一个 LoadBalancer 服务，在Kubernetes集群外部公开搜索Pod。

以下服务使用可从Kubernetes集群外部访问的外部IP解决或主机名公开端口 27027 上的 MongoDBSearch 服务。

kubectl apply --context "${K8S_CTX}" -n "${MDB_NS}" -f - <<YAMLapiVersion: v1kind: Servicemetadata:  name: ${MDB_SEARCH_HOSTNAME}spec:  type: LoadBalancer  selector:    app: mdbs-search-svc  ports:    - name: mongot      port: 27027      targetPort: 27027YAML
echo "Waiting for external IP to be assigned to service ${MDB_SEARCH_HOSTNAME}..."TIMEOUT=120  # 2 minutes timeoutELAPSED=0while [ ${ELAPSED} -lt ${TIMEOUT} ]; do  EXTERNAL_IP=$(kubectl get service "${MDB_SEARCH_HOSTNAME}" --context "${K8S_CTX}" -n "${MDB_NS}" -o jsonpath='{.status.loadBalancer.ingress[0].ip}' 2>/dev/null)  if [ -n "${EXTERNAL_IP}" ] && [ "${EXTERNAL_IP}" != "null" ]; then    echo "External IP assigned: ${EXTERNAL_IP}"    break  fi  echo "Still waiting for external IP assignment... (${ELAPSED}s/${TIMEOUT}s)"  sleep 5  ELAPSED=$((ELAPSED + 5))done
if [ ${ELAPSED} -ge ${TIMEOUT} ]; then  echo "ERROR: Timeout reached (${TIMEOUT}s) while waiting for external IP assignment"  echo "LoadBalancer service may take longer to provision or there may be an issue"  exit 1fi
5

可选。查看命名空间中所有运行的Pod。

查看MongoDB副本集成员、 Kubernetes Operator 的MongoDB控制器以及搜索节点的命名空间Pod 中运行的所有 Pod。

echo; echo "MongoDBSearch resource"kubectl --context "${K8S_CTX}" -n "${MDB_NS}" get mdbs/mdbsecho; echo "Search pods running in cluster ${K8S_CTX}"kubectl --context "${K8S_CTX}" -n "${MDB_NS}" get pods -l app=mdbs-search-svcecho; echo "All pods in namespace ${MDB_NS}"kubectl --context "${K8S_CTX}" -n "${MDB_NS}" get pods

后续步骤

现在，您已成功部署MongoDB Search 和 Vector Search 以与外部MongoDB Enterprise Edition 一起使用，您可以将数据添加到MongoDB 集群，创建MongoDB Search 和 Vector Search 索引，并对数据运行查询。要学习；了解更多信息，请参阅MongoDB搜索和向量搜索设置。

给本页内容打分

在此页面上