Docs 菜单
Docs 主页
/
适用于Kubernetes Operator 的MongoDB控制器
/

安装和使用MongoDB Enterprise Edition 搜索

您可以使用Kubernetes Operator部署MongoDB Search 和 Vector Search 资源,以便在Kubernetes集群上与MongoDB 企业 v8.0.10 或更高版本一起运行。此过程演示了如何部署和配置 mongot进程,使其与Kubernetes集群中的新副本集一起运行。

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

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

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

  • Helm ,即Kubernetes的包管理器,用于安装Kubernetes Operator。

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

  • MongoDB Ops Manager或MongoDB Cloud Manager项目和 API凭证。

1

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

1# set it to the context name of the k8s cluster
2export K8S_CTX="<local cluster context>"
3
4# the following namespace will be created if not exists
5export MDB_NS="mongodb"
6
7# name of the MongoDB Custom Resource.
8export MDB_RESOURCE_NAME="mdb-rs"
9
10# OM/CM's project name to be used to manage mongodb replica set
11export OPS_MANAGER_PROJECT_NAME="<arbitrary project name>"
12
13# URL to Cloud Manager or Ops Manager instance
14export OPS_MANAGER_API_URL="https://cloud-qa.mongodb.com"
15
16# The API key can be an Org Owner - the operator can create the project automatically then.
17# The API key can also be created in a particular project that was created manually with the Project Owner scope .
18export OPS_MANAGER_API_USER="abcdefg"
19export OPS_MANAGER_API_KEY="00000-abcd-efgh-1111-12345678"
20export OPS_MANAGER_ORG_ID="62a73abcdefgh12345678"
21
22# minimum required MongoDB version for running MongoDB Search is 8.0.10
23export MDB_VERSION="8.0.10"
24
25# root admin user for convenience, not used here at all in this guide
26export MDB_ADMIN_USER_PASSWORD="admin-user-password-CHANGE-ME"
27# regular user performing restore and search queries on sample mflix database
28export MDB_USER_PASSWORD="mdb-user-password-CHANGE-ME"
29# user for MongoDB Search to connect to the replica set to synchronise data from
30export MDB_SEARCH_SYNC_USER_PASSWORD="search-sync-user-password-CHANGE-ME"
31
32export OPERATOR_HELM_CHART="mongodb/mongodb-kubernetes"
33# comma-separated key=value pairs for additional parameters passed to the helm-chart installing the operator
34export OPERATOR_ADDITIONAL_HELM_VALUES=""
35
36export MDB_CONNECTION_STRING="mongodb://mdb-user:${MDB_USER_PASSWORD}@${MDB_RESOURCE_NAME}-svc.${MDB_NS}.svc.cluster.local:27017/?replicaSet=${MDB_RESOURCE_NAME}"
2

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

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

1helm repo add mongodb https://mongodb.github.io/helm-charts
2helm repo update mongodb
3helm search repo mongodb/mongodb-kubernetes
1"mongodb" already exists with the same configuration, skipping
2Hang tight while we grab the latest from your chart repositories...
3...Successfully got an update from the "mongodb" chart repository
4Update Complete. ⎈Happy Helming!⎈
5NAME CHART VERSION APP VERSION DESCRIPTION
6mongodb/mongodb-kubernetes 1.3.0 MongoDB Controllers for Kubernetes translate th...
3

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

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

1helm upgrade --install --debug --kube-context "${K8S_CTX}" \
2 --create-namespace \
3 --namespace="${MDB_NS}" \
4 mongodb-kubernetes \
5 ${OPERATOR_ADDITIONAL_HELM_VALUES:+--set ${OPERATOR_ADDITIONAL_HELM_VALUES}} \
6 "${OPERATOR_HELM_CHART}"
1Release "mongodb-kubernetes" does not exist. Installing it now.
2NAME: mongodb-kubernetes
3LAST DEPLOYED: Tue Sep 16 14:11:48 2025
4NAMESPACE: mongodb
5STATUS: deployed
6REVISION: 1
7TEST SUITE: None
8USER-SUPPLIED VALUES:
9{}
10
11COMPUTED VALUES:
12agent:
13 name: mongodb-agent
14 version: 108.0.12.8846-1
15community:
16 agent:
17 name: mongodb-agent
18 version: 108.0.2.8729-1
19 mongodb:
20 imageType: ubi8
21 name: mongodb-community-server
22 repo: quay.io/mongodb
23 registry:
24 agent: quay.io/mongodb
25 resource:
26 members: 3
27 name: mongodb-replica-set
28 tls:
29 caCertificateSecretRef: tls-ca-key-pair
30 certManager:
31 certDuration: 8760h
32 renewCertBefore: 720h
33 certificateKeySecretRef: tls-certificate
34 enabled: false
35 sampleX509User: false
36 useCertManager: true
37 useX509: false
38 version: 4.4.0
39database:
40 name: mongodb-kubernetes-database
41 version: 1.4.0
42initAppDb:
43 name: mongodb-kubernetes-init-appdb
44 version: 1.4.0
45initDatabase:
46 name: mongodb-kubernetes-init-database
47 version: 1.4.0
48initOpsManager:
49 name: mongodb-kubernetes-init-ops-manager
50 version: 1.4.0
51managedSecurityContext: false
52mongodb:
53 appdbAssumeOldFormat: false
54 imageType: ubi8
55 name: mongodb-enterprise-server
56 repo: quay.io/mongodb
57multiCluster:
58 clusterClientTimeout: 10
59 clusters: []
60 kubeConfigSecretName: mongodb-enterprise-operator-multi-cluster-kubeconfig
61 performFailOver: true
62operator:
63 additionalArguments: []
64 affinity: {}
65 baseName: mongodb-kubernetes
66 createOperatorServiceAccount: true
67 createResourcesServiceAccountsAndRoles: true
68 deployment_name: mongodb-kubernetes-operator
69 enableClusterMongoDBRoles: true
70 enablePVCResize: true
71 env: prod
72 maxConcurrentReconciles: 1
73 mdbDefaultArchitecture: non-static
74 name: mongodb-kubernetes-operator
75 nodeSelector: {}
76 operator_image_name: mongodb-kubernetes
77 replicas: 1
78 resources:
79 limits:
80 cpu: 1100m
81 memory: 1Gi
82 requests:
83 cpu: 500m
84 memory: 200Mi
85 telemetry:
86 collection:
87 clusters: {}
88 deployments: {}
89 frequency: 1h
90 operators: {}
91 send:
92 frequency: 168h
93 tolerations: []
94 vaultSecretBackend:
95 enabled: false
96 tlsSecretRef: ""
97 version: 1.4.0
98 watchedResources:
99 - mongodb
100 - opsmanagers
101 - mongodbusers
102 - mongodbcommunity
103 - mongodbsearch
104 webhook:
105 installClusterRole: true
106 registerConfiguration: true
107opsManager:
108 name: mongodb-enterprise-ops-manager-ubi
109readinessProbe:
110 name: mongodb-kubernetes-readinessprobe
111 version: 1.0.22
112registry:
113 agent: quay.io/mongodb
114 database: quay.io/mongodb
115 imagePullSecrets: null
116 initAppDb: quay.io/mongodb
117 initDatabase: quay.io/mongodb
118 initOpsManager: quay.io/mongodb
119 operator: quay.io/mongodb
120 opsManager: quay.io/mongodb
121 pullPolicy: Always
122 readinessProbe: quay.io/mongodb
123 versionUpgradeHook: quay.io/mongodb
124search:
125 name: mongodb-search
126 repo: quay.io/mongodb
127 version: 0.53.1
128versionUpgradeHook:
129 name: mongodb-kubernetes-operator-version-upgrade-post-start-hook
130 version: 1.0.9
131
132HOOKS:
133MANIFEST:
134---
135# Source: mongodb-kubernetes/templates/database-roles.yaml
136apiVersion: v1
137kind: ServiceAccount
138metadata:
139 name: mongodb-kubernetes-appdb
140 namespace: mongodb
141---
142# Source: mongodb-kubernetes/templates/database-roles.yaml
143apiVersion: v1
144kind: ServiceAccount
145metadata:
146 name: mongodb-kubernetes-database-pods
147 namespace: mongodb
148---
149# Source: mongodb-kubernetes/templates/database-roles.yaml
150apiVersion: v1
151kind: ServiceAccount
152metadata:
153 name: mongodb-kubernetes-ops-manager
154 namespace: mongodb
155---
156# Source: mongodb-kubernetes/templates/operator-sa.yaml
157apiVersion: v1
158kind: ServiceAccount
159metadata:
160 name: mongodb-kubernetes-operator
161 namespace: mongodb
162---
163# Source: mongodb-kubernetes/templates/operator-roles-clustermongodbroles.yaml
164kind: ClusterRole
165apiVersion: rbac.authorization.k8s.io/v1
166metadata:
167 name: mongodb-kubernetes-operator-mongodb-cluster-mongodb-role
168rules:
169 - apiGroups:
170 - mongodb.com
171 verbs:
172 - '*'
173 resources:
174 - clustermongodbroles
175---
176# Source: mongodb-kubernetes/templates/operator-roles-telemetry.yaml
177# Additional ClusterRole for clusterVersionDetection
178kind: ClusterRole
179apiVersion: rbac.authorization.k8s.io/v1
180metadata:
181 name: mongodb-kubernetes-operator-cluster-telemetry
182rules:
183 # Non-resource URL permissions
184 - nonResourceURLs:
185 - "/version"
186 verbs:
187 - get
188 # Cluster-scoped resource permissions
189 - apiGroups:
190 - ''
191 resources:
192 - namespaces
193 resourceNames:
194 - kube-system
195 verbs:
196 - get
197 - apiGroups:
198 - ''
199 resources:
200 - nodes
201 verbs:
202 - list
203---
204# Source: mongodb-kubernetes/templates/operator-roles-webhook.yaml
205kind: ClusterRole
206apiVersion: rbac.authorization.k8s.io/v1
207metadata:
208 name: mongodb-kubernetes-operator-mongodb-webhook-cr
209rules:
210 - apiGroups:
211 - "admissionregistration.k8s.io"
212 resources:
213 - validatingwebhookconfigurations
214 verbs:
215 - get
216 - create
217 - update
218 - delete
219 - apiGroups:
220 - ""
221 resources:
222 - services
223 verbs:
224 - get
225 - list
226 - watch
227 - create
228 - update
229 - delete
230---
231# Source: mongodb-kubernetes/templates/operator-roles-clustermongodbroles.yaml
232kind: ClusterRoleBinding
233apiVersion: rbac.authorization.k8s.io/v1
234metadata:
235 name: mongodb-kubernetes-operator-mongodb-cluster-mongodb-role-binding
236roleRef:
237 apiGroup: rbac.authorization.k8s.io
238 kind: ClusterRole
239 name: mongodb-kubernetes-operator-mongodb-cluster-mongodb-role
240subjects:
241 - kind: ServiceAccount
242 name: mongodb-kubernetes-operator
243 namespace: mongodb
244---
245# Source: mongodb-kubernetes/templates/operator-roles-telemetry.yaml
246# ClusterRoleBinding for clusterVersionDetection
247kind: ClusterRoleBinding
248apiVersion: rbac.authorization.k8s.io/v1
249metadata:
250 name: mongodb-kubernetes-operator-mongodb-cluster-telemetry-binding
251roleRef:
252 apiGroup: rbac.authorization.k8s.io
253 kind: ClusterRole
254 name: mongodb-kubernetes-operator-cluster-telemetry
255subjects:
256 - kind: ServiceAccount
257 name: mongodb-kubernetes-operator
258 namespace: mongodb
259---
260# Source: mongodb-kubernetes/templates/operator-roles-webhook.yaml
261kind: ClusterRoleBinding
262apiVersion: rbac.authorization.k8s.io/v1
263metadata:
264 name: mongodb-kubernetes-operator-mongodb-webhook-crb
265roleRef:
266 apiGroup: rbac.authorization.k8s.io
267 kind: ClusterRole
268 name: mongodb-kubernetes-operator-mongodb-webhook-cr
269subjects:
270 - kind: ServiceAccount
271 name: mongodb-kubernetes-operator
272 namespace: mongodb
273---
274# Source: mongodb-kubernetes/templates/database-roles.yaml
275kind: Role
276apiVersion: rbac.authorization.k8s.io/v1
277metadata:
278 name: mongodb-kubernetes-appdb
279 namespace: mongodb
280rules:
281 - apiGroups:
282 - ''
283 resources:
284 - secrets
285 verbs:
286 - get
287 - apiGroups:
288 - ''
289 resources:
290 - pods
291 verbs:
292 - patch
293 - delete
294 - get
295---
296# Source: mongodb-kubernetes/templates/operator-roles-base.yaml
297kind: Role
298apiVersion: rbac.authorization.k8s.io/v1
299metadata:
300 name: mongodb-kubernetes-operator
301 namespace: mongodb
302rules:
303 - apiGroups:
304 - ''
305 resources:
306 - services
307 verbs:
308 - get
309 - list
310 - watch
311 - create
312 - update
313 - delete
314 - apiGroups:
315 - ''
316 resources:
317 - secrets
318 - configmaps
319 verbs:
320 - get
321 - list
322 - create
323 - update
324 - delete
325 - watch
326 - apiGroups:
327 - apps
328 resources:
329 - statefulsets
330 verbs:
331 - create
332 - get
333 - list
334 - watch
335 - delete
336 - update
337 - apiGroups:
338 - ''
339 resources:
340 - pods
341 verbs:
342 - get
343 - list
344 - watch
345 - delete
346 - deletecollection
347 - apiGroups:
348 - mongodbcommunity.mongodb.com
349 resources:
350 - mongodbcommunity
351 - mongodbcommunity/status
352 - mongodbcommunity/spec
353 - mongodbcommunity/finalizers
354 verbs:
355 - '*'
356 - apiGroups:
357 - mongodb.com
358 verbs:
359 - '*'
360 resources:
361 - mongodb
362 - mongodb/finalizers
363 - mongodbusers
364 - mongodbusers/finalizers
365 - opsmanagers
366 - opsmanagers/finalizers
367 - mongodbmulticluster
368 - mongodbmulticluster/finalizers
369 - mongodbsearch
370 - mongodbsearch/finalizers
371 - mongodb/status
372 - mongodbusers/status
373 - opsmanagers/status
374 - mongodbmulticluster/status
375 - mongodbsearch/status
376---
377# Source: mongodb-kubernetes/templates/operator-roles-pvc-resize.yaml
378kind: Role
379apiVersion: rbac.authorization.k8s.io/v1
380metadata:
381 name: mongodb-kubernetes-operator-pvc-resize
382 namespace: mongodb
383rules:
384 - apiGroups:
385 - ''
386 resources:
387 - persistentvolumeclaims
388 verbs:
389 - get
390 - delete
391 - list
392 - watch
393 - patch
394 - update
395---
396# Source: mongodb-kubernetes/templates/database-roles.yaml
397kind: RoleBinding
398apiVersion: rbac.authorization.k8s.io/v1
399metadata:
400 name: mongodb-kubernetes-appdb
401 namespace: mongodb
402roleRef:
403 apiGroup: rbac.authorization.k8s.io
404 kind: Role
405 name: mongodb-kubernetes-appdb
406subjects:
407 - kind: ServiceAccount
408 name: mongodb-kubernetes-appdb
409 namespace: mongodb
410---
411# Source: mongodb-kubernetes/templates/operator-roles-base.yaml
412kind: RoleBinding
413apiVersion: rbac.authorization.k8s.io/v1
414metadata:
415 name: mongodb-kubernetes-operator
416 namespace: mongodb
417roleRef:
418 apiGroup: rbac.authorization.k8s.io
419 kind: Role
420 name: mongodb-kubernetes-operator
421subjects:
422 - kind: ServiceAccount
423 name: mongodb-kubernetes-operator
424 namespace: mongodb
425---
426# Source: mongodb-kubernetes/templates/operator-roles-pvc-resize.yaml
427kind: RoleBinding
428apiVersion: rbac.authorization.k8s.io/v1
429metadata:
430 name: mongodb-kubernetes-operator-pvc-resize-binding
431 namespace: mongodb
432roleRef:
433 apiGroup: rbac.authorization.k8s.io
434 kind: Role
435 name: mongodb-kubernetes-operator-pvc-resize
436subjects:
437 - kind: ServiceAccount
438 name: mongodb-kubernetes-operator
439 namespace: mongodb
440---
441# Source: mongodb-kubernetes/templates/operator.yaml
442apiVersion: apps/v1
443kind: Deployment
444metadata:
445 name: mongodb-kubernetes-operator
446 namespace: mongodb
447spec:
448 replicas: 1
449 selector:
450 matchLabels:
451 app.kubernetes.io/component: controller
452 app.kubernetes.io/name: mongodb-kubernetes-operator
453 app.kubernetes.io/instance: mongodb-kubernetes-operator
454 template:
455 metadata:
456 labels:
457 app.kubernetes.io/component: controller
458 app.kubernetes.io/name: mongodb-kubernetes-operator
459 app.kubernetes.io/instance: mongodb-kubernetes-operator
460 spec:
461 serviceAccountName: mongodb-kubernetes-operator
462 securityContext:
463 runAsNonRoot: true
464 runAsUser: 2000
465 containers:
466 - name: mongodb-kubernetes-operator
467 image: "quay.io/mongodb/mongodb-kubernetes:1.4.0"
468 imagePullPolicy: Always
469 args:
470 - -watch-resource=mongodb
471 - -watch-resource=opsmanagers
472 - -watch-resource=mongodbusers
473 - -watch-resource=mongodbcommunity
474 - -watch-resource=mongodbsearch
475 - -watch-resource=clustermongodbroles
476 command:
477 - /usr/local/bin/mongodb-kubernetes-operator
478 resources:
479 limits:
480 cpu: 1100m
481 memory: 1Gi
482 requests:
483 cpu: 500m
484 memory: 200Mi
485 env:
486 - name: OPERATOR_ENV
487 value: prod
488 - name: MDB_DEFAULT_ARCHITECTURE
489 value: non-static
490 - name: NAMESPACE
491 valueFrom:
492 fieldRef:
493 fieldPath: metadata.namespace
494 - name: WATCH_NAMESPACE
495 valueFrom:
496 fieldRef:
497 fieldPath: metadata.namespace
498 - name: MDB_OPERATOR_TELEMETRY_COLLECTION_FREQUENCY
499 value: "1h"
500 - name: MDB_OPERATOR_TELEMETRY_SEND_FREQUENCY
501 value: "168h"
502 - name: CLUSTER_CLIENT_TIMEOUT
503 value: "10"
504 - name: IMAGE_PULL_POLICY
505 value: Always
506 # Database
507 - name: MONGODB_ENTERPRISE_DATABASE_IMAGE
508 value: quay.io/mongodb/mongodb-kubernetes-database
509 - name: INIT_DATABASE_IMAGE_REPOSITORY
510 value: quay.io/mongodb/mongodb-kubernetes-init-database
511 - name: INIT_DATABASE_VERSION
512 value: 1.4.0
513 - name: DATABASE_VERSION
514 value: 1.4.0
515 # Ops Manager
516 - name: OPS_MANAGER_IMAGE_REPOSITORY
517 value: quay.io/mongodb/mongodb-enterprise-ops-manager-ubi
518 - name: INIT_OPS_MANAGER_IMAGE_REPOSITORY
519 value: quay.io/mongodb/mongodb-kubernetes-init-ops-manager
520 - name: INIT_OPS_MANAGER_VERSION
521 value: 1.4.0
522 # AppDB
523 - name: INIT_APPDB_IMAGE_REPOSITORY
524 value: quay.io/mongodb/mongodb-kubernetes-init-appdb
525 - name: INIT_APPDB_VERSION
526 value: 1.4.0
527 - name: OPS_MANAGER_IMAGE_PULL_POLICY
528 value: Always
529 - name: AGENT_IMAGE
530 value: "quay.io/mongodb/mongodb-agent:108.0.12.8846-1"
531 - name: MDB_AGENT_IMAGE_REPOSITORY
532 value: "quay.io/mongodb/mongodb-agent"
533 - name: MONGODB_IMAGE
534 value: mongodb-enterprise-server
535 - name: MONGODB_REPO_URL
536 value: quay.io/mongodb
537 - name: MDB_IMAGE_TYPE
538 value: ubi8
539 - name: PERFORM_FAILOVER
540 value: 'true'
541 - name: MDB_MAX_CONCURRENT_RECONCILES
542 value: "1"
543 - name: POD_NAME
544 valueFrom:
545 fieldRef:
546 fieldPath: metadata.name
547 - name: OPERATOR_NAME
548 value: mongodb-kubernetes-operator
549 # Community Env Vars Start
550 - name: MDB_COMMUNITY_AGENT_IMAGE
551 value: "quay.io/mongodb/mongodb-agent:108.0.2.8729-1"
552 - name: VERSION_UPGRADE_HOOK_IMAGE
553 value: "quay.io/mongodb/mongodb-kubernetes-operator-version-upgrade-post-start-hook:1.0.9"
554 - name: READINESS_PROBE_IMAGE
555 value: "quay.io/mongodb/mongodb-kubernetes-readinessprobe:1.0.22"
556 - name: MDB_COMMUNITY_IMAGE
557 value: "mongodb-community-server"
558 - name: MDB_COMMUNITY_REPO_URL
559 value: "quay.io/mongodb"
560 - name: MDB_COMMUNITY_IMAGE_TYPE
561 value: "ubi8"
562 # Community Env Vars End
563 - name: MDB_SEARCH_REPO_URL
564 value: "quay.io/mongodb"
565 - name: MDB_SEARCH_NAME
566 value: "mongodb-search"
567 - name: MDB_SEARCH_VERSION
568 value: "0.53.1"
4

如果您已部署MongoDB Enterprise,请跳至下一步。否则,部署MongoDB Enterprise资源。

要部署MongoDB Enterprise,请完成以下步骤:

  1. 创建名为 mdb-rsMongoDB 自定义资源。

    该资源定义了 mongodmongodb-agent 容器的 CPU 和内存资源,并指示Kubernetes Operator 配置具有 3 成员的MongoDB副本集:

    要部署MongoDB Enterprise ,请在命名空间中复制、粘贴并运行以下命令:

    1kubectl apply --context "${K8S_CTX}" -n "${MDB_NS}" -f - <<EOF
    2apiVersion: mongodb.com/v1
    3kind: MongoDB
    4metadata:
    5 name: ${MDB_RESOURCE_NAME}
    6spec:
    7 members: 3
    8 version: ${MDB_VERSION}-ent
    9 type: ReplicaSet
    10 opsManager:
    11 configMapRef:
    12 name: om-project
    13 credentials: om-credentials
    14 security:
    15 authentication:
    16 enabled: true
    17 ignoreUnknownUsers: true
    18 modes:
    19 - SCRAM
    20 agent:
    21 logLevel: DEBUG
    22 statefulSet:
    23 spec:
    24 template:
    25 spec:
    26 containers:
    27 - name: mongodb-enterprise-database
    28 resources:
    29 limits:
    30 cpu: "2"
    31 memory: 2Gi
    32 requests:
    33 cpu: "1"
    34 memory: 1Gi
    35EOF
  2. 等待 MongoDB资源部署完成。

    当您应用MongoDB 自定义资源时, Kubernetes 操作符开始部署MongoDB节点 (Pod)。此步骤会暂停执行,直到 mdbc-rs 资源的状态阶段为 Running,这表示MongoDB Community副本集可操作。

    1echo "Waiting for MongoDB resource to reach Running phase..."
    2kubectl --context "${K8S_CTX}" -n "${MDB_NS}" wait --for=jsonpath='{.status.phase}'=Running "mdb/${MDB_RESOURCE_NAME}" --timeout=400s
    3echo; echo "MongoDB resource"
    4kubectl --context "${K8S_CTX}" -n "${MDB_NS}" get "mdb/${MDB_RESOURCE_NAME}"
    5echo; echo "Pods running in cluster ${K8S_CTX}"
    6kubectl --context "${K8S_CTX}" -n "${MDB_NS}" get pods
    1Waiting for MongoDB resource to reach Running phase...
    2mongodb.mongodb.mongodb.com/mdbc-rs condition met
    3
    4MongoDB resource
    5NAME PHASE VERSION
    6mdbc-rs Running 8.0.10
    7
    8Pods running in cluster minikube
    9NAME READY STATUS RESTARTS AGE
    10mdbc-rs-0 2/2 Running 0 2m30s
    11mdbc-rs-1 2/2 Running 0 82s
    12mdbc-rs-2 2/2 Running 0 38s
    13mongodb-kubernetes-operator-5776c8b4df-cppnf 1/1 Running 0 7m37s
5

MongoDB需要身份验证才能安全访问权限。在此步骤中,您将创建三个Kubernetes密钥:

  • mdb-admin-user-password: MongoDB管理员的档案。

  • mdb-user-password:授权执行搜索查询的用户的档案。

  • mdbc-rs-search-sync-source-password:专用搜索用户的档案,由 mongot进程在内部用于同步数据和管理索引。

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

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

1# admin user with root role
2kubectl --context "${K8S_CTX}" --namespace "${MDB_NS}" \
3 create secret generic mdb-admin-user-password \
4 --from-literal=password="${MDB_ADMIN_USER_PASSWORD}"
5
6kubectl apply --context "${K8S_CTX}" -n "${MDB_NS}" -f - <<EOF
7apiVersion: mongodb.com/v1
8kind: MongoDBUser
9metadata:
10 name: mdb-admin
11spec:
12 username: mdb-admin
13 db: admin
14 mongodbResourceRef:
15 name: ${MDB_RESOURCE_NAME}
16 passwordSecretKeyRef:
17 name: mdb-admin-user-password
18 key: password
19 roles:
20 - name: root
21 db: admin
22EOF
23
24# user used by MongoDB Search to connect to MongoDB database to synchronize data from
25# For MongoDB <8.2, the operator will be creating the searchCoordinator custom role automatically
26# From MongoDB 8.2, searchCoordinator role will be a built-in role.
27kubectl --context "${K8S_CTX}" --namespace "${MDB_NS}" \
28 create secret generic mdb-rs-search-sync-source-password \
29 --from-literal=password="${MDB_SEARCH_SYNC_USER_PASSWORD}"
30kubectl apply --context "${K8S_CTX}" -n "${MDB_NS}" -f - <<EOF
31apiVersion: mongodb.com/v1
32kind: MongoDBUser
33metadata:
34 name: search-sync-source-user
35spec:
36 username: search-sync-source
37 db: admin
38 mongodbResourceRef:
39 name: ${MDB_RESOURCE_NAME}
40 passwordSecretKeyRef:
41 name: mdb-rs-search-sync-source-password
42 key: password
43 roles:
44 - name: searchCoordinator
45 db: admin
46EOF
47
48# user performing search queries
49kubectl --context "${K8S_CTX}" --namespace "${MDB_NS}" \
50 create secret generic mdb-user-password \
51 --from-literal=password="${MDB_USER_PASSWORD}"
52kubectl apply --context "${K8S_CTX}" -n "${MDB_NS}" -f - <<EOF
53apiVersion: mongodb.com/v1
54kind: MongoDBUser
55metadata:
56 name: mdb-user
57spec:
58 username: mdb-user
59 db: admin
60 mongodbResourceRef:
61 name: ${MDB_RESOURCE_NAME}
62 passwordSecretKeyRef:
63 name: mdb-user-password
64 key: password
65 roles:
66 - name: readWrite
67 db: sample_mflix
68EOF
1secret/mdb-admin-user-password created
2secret/mdbc-rs-search-sync-source-password created
3secret/mdb-user-password created
6

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

  1. 创建名为 mdbc-rsMongoDBSearch 自定义资源。

    此资源指定搜索节点的 CPU 和内存资源要求。要学习;了解有关此自定义资源中设置的更多信息,请参阅 MongoDB搜索和向量搜索设置。

    1kubectl apply --context "${K8S_CTX}" -n "${MDB_NS}" -f - <<EOF
    2apiVersion: mongodb.com/v1
    3kind: MongoDBSearch
    4metadata:
    5 name: ${MDB_RESOURCE_NAME}
    6spec:
    7 # no need to specify source.mongodbResourceRef if MongoDBSearch CR has the same name as MongoDB CR
    8 # the operator infer it automatically
    9 resourceRequirements:
    10 limits:
    11 cpu: "3"
    12 memory: 5Gi
    13 requests:
    14 cpu: "2"
    15 memory: 3Gi
    16EOF
  2. 等待 MongoDBSearch资源部署完成。

    当您应用MongoDBSearch 自定义资源时, Kubernetes 操作符开始部署搜索节点 (pod)。此步骤会暂停执行,直到 mdbc-rs 资源的状态阶段为 Running,这表示MongoDB Community副本集可操作。

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

确保使用 MongoDBSearch成功部署MongoDB资源。

1echo "Waiting for MongoDB resource to reach Running phase..."
2kubectl --context "${K8S_CTX}" -n "${MDB_NS}" wait --for=jsonpath='{.status.phase}'=Running "mdb/${MDB_RESOURCE_NAME}" --timeout=400s
8

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

1echo; echo "MongoDB resource"
2kubectl --context "${K8S_CTX}" -n "${MDB_NS}" get "mdb/${MDB_RESOURCE_NAME}"
3echo; echo "MongoDBSearch resource"
4kubectl --context "${K8S_CTX}" -n "${MDB_NS}" get mdbs/mdb-rs
5echo; echo "Pods running in cluster ${K8S_CTX}"
6kubectl --context "${K8S_CTX}" -n "${MDB_NS}" get pods
1MongoDB resource
2NAME PHASE VERSION TYPE AGE
3mdb-rs Running 8.0.10-ent ReplicaSet 7m57s
4
5MongoDBSearch resource
6NAME PHASE AGE
7mdb-rs Running 5m26s
8
9Pods running in cluster kind-kind
10NAME READY STATUS RESTARTS AGE
11mdb-rs-0 1/1 Running 0 7m54s
12mdb-rs-1 1/1 Running 0 7m13s
13mdb-rs-2 1/1 Running 0 6m47s
14mdb-rs-search-0 1/1 Running 0 4m8s
15mongodb-kubernetes-operator-fc996f567-jl595 1/1 Running 0 7m59s

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

在此页面上