部署 Ops Manager 资源

将 kubectl 配置为默认命名空间。

如果您尚未执行，请运行以下命令，执行所创建命名空间的所有 kubectl 命令。

kubectl config set-context $(kubectl config current-context) --namespace=<metadata.namespace>

为证书创建密钥。

如果您使用 HashiCorp Vault 作为您的 Secret 存储工具，则可以创建 Vault Secret。

要了解有关 Secret 存储的选项，请参阅配置 Secret 存储。

1. 获得 TLS 证书和私钥后，运行以下命令以创建用于存储MongoDB Ops Manager 的 TLS 证书的密钥：

   kubectl create secret tls <prefix>-<metadata.name>-cert \
     --cert=<om-tls-cert> \
     --key=<om-tls-key>

2. 运行以下命令，创建用于存储应用程序数据库的 TLS 证书的新密钥：

   kubectl create secret tls <prefix>-<metadata.name>-db-cert \
     --cert=<appdb-tls-cert> \
     --key=<appdb-tls-key>

为自定义CA证书添加其他证书。

如果您的MongoDB Ops Manager TLS 证书由自定义 CA 签名，则该 CA 证书还必须包含允许MongoDB Ops Manager备份守护程序从互联网下载MongoDB二进制文件的其他证书。要创建TLS证书，请创建ConfigMap来保存CA证书：

1. 从downloads.mongodb.com获取 Ops Manager 的整个TLS证书链。 以下openssl命令将链中的证书以.crt格式输出到当前工作目录：

   openssl s_client -showcerts -verify 2 \
   -connect downloads.mongodb.com:443 -servername downloads.mongodb.com < /dev/null \
   | awk '/BEGIN/,/END/{ if(/BEGIN/){a++}; out="cert"a".crt"; print >out}'

2. 将 Ops Manager 的CA证书文件与您在上一步中获得的来自downloads.mongodb.com的整个TLS证书链连接：

   cat <custom_ca_cert.pem> cert2.crt cert3.crt cert4.crt  >> mms-ca.crt

   注意

   • 将占位符 <custom_ca_cert.pem> 替换为您的自定义 CA 证书 PEM文件。

   • 请勿包含 cert1.crt文件，因为不应包含来自MongoDB的服务器证书。

3. 为MongoDB Ops Manager创建 ConfigMap：

   kubectl create configmap om-http-cert-ca --from-file="mms-ca.crt"

复制以下Ops Manager Kubernetes 对象 示例之一。

更改设置以匹配您的 Ops Manager 和应用程序数据库配置。

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDBOpsManager
4
metadata:
5
  name: <myopsmanager>
6
spec:
7
  replicas: 1
8
  version: <opsmanagerversion>
9
  adminCredentials: <adminusercredentials> # Should match metadata.name
10
                                           # in the Kubernetes secret
11
                                           # for the admin user
12
13
  externalConnectivity:
14
    type: LoadBalancer
15
  security:
16
      certsSecretPrefix: <prefix> # Required. Text to prefix 
17
                                  # the name of the secret that contains
18
                                  # Ops Manager's TLS certificate.
19
      tls:
20
        ca: "om-http-cert-ca"  # Optional. Name of the ConfigMap file
21
                               # containing the certificate authority that
22
                               # signs the certificates used by the Ops
23
                               # Manager custom resource.
24
25
  applicationDatabase:
26
    topology: SingleCluster
27
    members: 3
28
    version: "8.0.0-ubi8"
29
    security:
30
      certsSecretPrefix: <prefix> # Required. Text to prefix to the 
31
                                  # name of the secret that contains the Application
32
                                  # Database's TLS certificate. Name the secret 
33
                                  # <prefix>-<metadata.name>-db-cert.
34
      tls:
35
        ca: "appdb-ca" # Optional, unless enabling TLS for |mms|. 
36
                       # Name of the ConfigMap file
37
                       # containing the certicate authority that
38
                       # signs the certificates used by the
39
                       # application database.
40
41
...

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDBOpsManager
4
metadata:
5
  name: <myopsmanager>
6
spec:
7
  replicas: 1
8
  version: <opsmanagerversion>
9
  adminCredentials: <adminusercredentials> # Should match metadata.name
10
                                           # in the Kubernetes secret
11
                                           # for the admin user
12
13
  externalConnectivity:
14
    type: LoadBalancer
15
  security:
16
      certsSecretPrefix: <prefix> # Required. Text to prefix 
17
                                  # the name of the secret that contains
18
                                  # Ops Manager's TLS certificate.
19
      tls:
20
        ca: "om-http-cert-ca"  # Optional. Name of the ConfigMap file
21
                               # containing the certificate authority that
22
                               # signs the certificates used by the Ops
23
                               # Manager custom resource.
24
25
  applicationDatabase:
26
    topology: MultiCluster
27
    clusterSpecList:
28
    - clusterName: cluster1.example.com
29
      members: 4
30
    - clusterName: cluster2.example.com
31
      members: 3
32
    - clusterName: cluster3.example.com
33
      members: 2
34
    version: "8.0.0-ubi8"
35
    security:
36
      certsSecretPrefix: <prefix> # Required. Text to prefix to the 
37
                                  # name of the secret that contains the Application
38
                                  # Database's TLS certificate. Name the secret 
39
                                  # <prefix>-<metadata.name>-db-cert.
40
      tls:
41
        ca: "appdb-ca" # Optional, unless enabling TLS for |mms|. 
42
                       # Name of the ConfigMap file
43
                       # containing the certicate authority that
44
                       # signs the certificates used by the
45
                       # application database.
46
47
...

打开您首选的文本编辑器，并将对象规范粘贴到新的文本文件中。

配置特定于您的部署的设置。

可选：配置备份设置。

要配置备份，必须启用备份，然后：

• 选择配置S 3快照存储或块存储存储。 如果同时部署S3快照存储和块存储存储， MongoDB Ops Manager会随机选择一个用于备份。

• 选择配置oplog存储或S 3 oplog存储。 如果同时部署oplog存储和S3 oplog存储， MongoDB Ops Manager会随机选择其中之一用于oplog备份。

您还必须配置S 3快照存储或块存储存储。

如果同时部署S3快照存储和块存储存储， MongoDB Ops Manager会随机选择一个用于备份。

要配置快照存储，请配置以下设置：

要配置块存储，请配置以下设置：

可选：为 Ops Manager 备份配置任何其他设置。

将要应用部署的任何可选备份设置添加到对象规范文件中。示例，对于每种类型的备份存储和MongoDB Ops Manager备份守护进程进程，您可以分配标签以将特定备份存储或备份守护进程进程与特定项目关联起来。 使用 OpsManager 资源的 spec.backup.[*].assignmentLabels 元素。

可选：为 Ops Manager 部署配置任何其他设置。

将要应用部署的任何可选设置添加到对象规范文件中。

.yaml使用 文件扩展名保存此文件。

创建你的 Ops Manager 实例。

在 Ops Manager 资源定义的文件名上运行以下kubectl命令：

kubectl apply -f <opsmgr-resource>.yaml

kubectl apply \
  --context "$MDB_CENTRAL_CLUSTER_FULL_NAME" \
  --namespace "mongodb"
   -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/master/public/samples/ops-manager/ops-manager-external.yaml

追踪你的 Ops Manager 实例的状态。

要检查 Ops Manager 资源的状态，请调用以下命令：

kubectl get om -o yaml -w

部署资源时，该命令会在status字段下返回类似于以下内容的输出：

status:
 applicationDatabase:
  lastTransition: "2022-04-01T09:49:22Z"
  message: AppDB Statefulset is not ready yet
  phase: Pending
  type: ""
  version: ""
 backup:
  phase: ""
 opsManager:
  phase: ""

Kubernetes Operator 按以下顺序协调资源：

1. 应用程序数据库。

2. Ops Manager。

3. 备份。

在前一个资源进入Running阶段之前，Kubernetes 操作符 不会协调某一资源。

在 Ops Manager 经理完成Pending阶段后，如果启用了备份，该命令会在status字段下返回类似于以下内容的输出：

status:
 applicationDatabase:
     lastTransition: "2022-04-01T09:50:20Z"
     members: 3
     phase: Running
     type: ReplicaSet
     version: "8.0.0-ubi8"
  backup:
   lastTransition: "2022-04-01T09:57:42Z"
   message: The MongoDB object <namespace>/<oplogresourcename>
     doesn't exist
   phase: Pending
   opsManager:
     lastTransition: "2023-04-01T09:57:40Z"
     phase: Running
     replicas: 1
     url: https://om-svc.cloudqa.svc.cluster.local:8443
     version: "8.0.0"

在配置备份数据库之前，备份将保持Pending状态。

资源完成Pending阶段后，该命令会在status字段下返回类似于以下内容的输出：

status:
  applicationDatabase:
     lastTransition: "2022-12-06T18:23:22Z"
     members: 3
     phase: Running
     type: ReplicaSet
     version: "8.0.0-ubi8"
   opsManager:
     lastTransition: "2022-12-06T18:23:26Z"
     message: The MongoDB object namespace/oplogdbname doesn't exist
     phase: Pending
     url: https://om-svc.dev.svc.cluster.local:8443
     version: ""

在配置备份数据库之前，备份将保持Pending状态。

访问 Ops Manager 应用程序。

根据您在 Kubernetes 中将流量路由到 Ops Manager 应用程序的方式，您采取的步骤会有所不同。如果已配置 Kubernetes 操作符 来为您创建 Kubernetes 服务，或者您手动创建了 Kubernetes 服务，请使用以下方法之一访问 Ops Manager 应用程序：

要了解如何使用第三方服务访问 Ops Manager 应用程序，请参阅您的解决方案的文档。

为 Kubernetes 操作符 创建档案。

要配置凭证，您必须创建MongoDB Ops Manager组织、生成编程API密钥并创建密钥。这些活动遵循“为Kubernetes Operator 创建凭证”页面上的先决条件和过程。

使用ConfigMap创建项目。

要创建项目，请遵循使用 ConfigMap 为每个MongoDB部署创建一个项目页面上的前提条件和步骤。

在项目 ConfigMap 中设置以下字段：

• 将 ConfigMap 中的 data.baseUrl 设置为MongoDB Ops Manager应用程序的URL 。 要查找此URL ，请调用以下命令：

  kubectl get om -o yaml -w

  该命令在status.opsManager.url字段中返回 Ops Manager 应用程序的 URL，与以下示例类似：

  status:
     applicationDatabase:
       lastTransition: "2022-12-06T18:23:22Z"
       members: 3
       phase: Running
       type: ReplicaSet
       version: "8.0.0-ubi8"
     opsManager:
       lastTransition: "2022-12-06T18:23:26Z"
       message: The MongoDB object namespace/oplogdbname doesn't exist
       phase: Pending
       url: https://om-svc.dev.svc.cluster.local:8443
       version: ""

  重要

  如果将 Ops Manager 与 Kubernetes Operator 一起部署，且 Ops Manager 将管理部署在 Kubernetes 集群外部的 MongoDB 数据库资源，则必须将 data.baseUrl 设置为与 Ops Manager 资源规范中的 spec.configuration.mms.centralUrl 设置相同的值。

  要学习；了解更多信息，请参阅管理外部MongoDB部署。

• 将data.sslMMSCAConfigMap 设置为 ConfigMap 的名称，其中包含用于签署MongoDB Ops Manager主机证书的根 CA 证书。Kubernetes Operator 要求您在 ConfigMap 中将此MongoDB Ops Manager资源的证书命名为 mms-ca.crt。

部署 MongoDB database 资源，完成备份配置。

默认， MongoDB Ops Manager启用备份。 为oplog和快照存储创建MongoDB 数据库资源以完成配置。

1. 在与 Ops Manager 资源相同的命名空间中为 oplog 存储部署MongoDB database资源。

   注意

   创建此数据库作为三成员副本集。

   将资源的metadata.name与您在 Ops Manager 资源定义中指定的spec.backup.opLogStores.mongodbResourceRef.name进行匹配。

2. 在与 MongoDB资源相同的命名空间中为 S3MongoDB Ops Manager 快照存储部署 数据库资源 。

   注意

   创建S 3快照存储作为副本集。

   将资源的metadata.name与您在 Ops Manager 资源定义中指定的spec.backup.s3Stores.mongodbResourceRef.name进行匹配。

确认 Ops Manager 资源正在运行。

要检查 Ops Manager 资源的状态，请调用以下命令：

kubectl get om -o yaml -w

当 Ops Manager 运行时，该命令会在status字段下返回类似于以下内容的输出：

status:
  applicationDatabase:
    lastTransition: "2022-12-06T17:46:15Z"
    members: 3
    phase: Running
    type: ReplicaSet
    version: "8.0.0-ubi8"
  opsManager:
    lastTransition: "2022-12-06T17:46:32Z"
    phase: Running
    replicas: 1
    url: https://om-backup-svc.dev.svc.cluster.local:8443
    version: "8.0.0"

有关资源部署状态的信息，请参阅排除 Kubernetes 操作符故障。

将 kubectl 配置为默认命名空间。

如果您尚未执行，请运行以下命令，执行所创建命名空间的所有 kubectl 命令。

kubectl config set-context $(kubectl config current-context) --namespace=<metadata.namespace>

复制以下Ops Manager Kubernetes 对象 示例之一。

更改设置以匹配您的MongoDB Ops Manager配置。

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDBOpsManager
4
metadata:
5
  name: <myopsmanager>
6
spec:
7
  replicas: 1
8
  version: <opsmanagerversion>
9
  adminCredentials: <adminusercredentials> # Should match metadata.name
10
                                           # in the secret
11
                                           # for the admin user
12
  externalConnectivity:
13
    type: LoadBalancer
14
15
  applicationDatabase:
16
    topology: SingleCluster
17
    members: 3
18
    version: <mongodbversion>
19
...

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDBOpsManager
4
metadata:
5
  name: <myopsmanager>
6
spec:
7
  replicas: 1
8
  version: <opsmanagerversion>
9
  adminCredentials: <adminusercredentials> # Should match metadata.name
10
                                           # in the Kubernetes secret
11
                                           # for the admin user
12
13
  externalConnectivity:
14
    type: LoadBalancer
15
16
  applicationDatabase:
17
    topology: MultiCluster
18
    clusterSpecList:
19
    - clusterName: cluster1.example.com
20
      members: 4
21
    - clusterName: cluster2.example.com
22
      members: 3
23
    - clusterName: cluster3.example.com
24
      members: 2
25
    version: "8.0.0-ubi8"
26
27
...

打开您首选的文本编辑器，并将对象规范粘贴到新的文本文件中。

配置上一示例中包含的设置。

可选：配置备份设置。

要配置备份，必须启用备份，然后：

• 选择配置S 3快照存储或块存储存储。 如果同时部署S3快照存储和块存储存储， MongoDB Ops Manager会随机选择一个用于备份。

• 选择配置oplog存储或S 3 oplog存储。 如果同时部署oplog存储和S3 oplog存储， MongoDB Ops Manager会随机选择其中之一用于oplog备份。

您还必须配置S 3快照存储或块存储存储。 如果同时部署S3快照存储和块存储存储， MongoDB Ops Manager会随机选择一个用于备份。

要配置S 3快照存储，请配置以下设置：

要配置块存储，请配置以下设置：

可选：为 Ops Manager 备份配置任何其他设置。

将要应用部署的任何可选备份设置添加到对象规范文件中。示例，对于每种类型的备份存储和MongoDB Ops Manager备份守护进程进程，您可以分配标签以将特定的备份备份存储或备份守护进程进程与特定项目关联起来。 使用 OpsManager 资源的 spec.backup.[*].assignmentLabels 元素。

可选：为 Ops Manager 部署配置任何其他设置。

将要应用部署的任何可选设置添加到对象规范文件中。

.yaml使用 文件扩展名保存此文件。

创建你的 Ops Manager 实例。

在 Ops Manager 资源定义的文件名上运行以下kubectl命令：

kubectl apply -f <opsmgr-resource>.yaml

kubectl apply \
  --context "$MDB_CENTRAL_CLUSTER_FULL_NAME" \
  --namespace "mongodb"
   -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/master/public/samples/ops-manager/ops-manager-external.yaml

追踪你的 Ops Manager 实例的状态。

要检查 Ops Manager 资源的状态，请调用以下命令：

kubectl get om -o yaml -w

部署资源时，该命令会在status字段下返回类似于以下内容的输出：

status:
 applicationDatabase:
  lastTransition: "2023-04-01T09:49:22Z"
  message: AppDB Statefulset is not ready yet
  phase: Pending
  type: ""
  version: ""
 backup:
  phase: ""
 opsManager:
  phase: ""

Kubernetes Operator 按以下顺序协调资源：

1. 应用程序数据库。

2. Ops Manager。

3. 备份。

在前一个资源进入Running阶段之前，Kubernetes 操作符 不会协调某一资源。

在MongoDB Ops Manager资源完成 Pending 阶段后，如果启用了备份，该命令会在 status 字段下返回类似于以下内容的输出：

 status:
   applicationDatabase:
     lastTransition: "2023-04-01T09:50:20Z"
     members: 3
     phase: Running
     type: ReplicaSet
     version: "8.0.0-ubi8"
  backup:
   lastTransition: "2022-04-01T09:57:42Z"
   message: The MongoDB object <namespace>/<oplogresourcename>
     doesn't exist
   phase: Pending
   opsManager:
     lastTransition: "2022-04-01T09:57:40Z"
     phase: Running
     replicas: 1
     url: http://om-svc.cloudqa.svc.cluster.local:8080
     version: "8.0.0"

在配置备份数据库之前，备份将保持Pending状态。

访问 Ops Manager 应用程序。

根据您在 Kubernetes 中将流量路由到 Ops Manager 应用程序的方式，您采取的步骤会有所不同。如果已配置 Kubernetes 操作符 来为您创建 Kubernetes 服务，或者您手动创建了 Kubernetes 服务，请使用以下方法之一访问 Ops Manager 应用程序：

要了解如何使用第三方服务访问 Ops Manager 应用程序，请参阅您的解决方案的文档。

可选：为凭证 Operator 创建Kubernetes。

如果启用了备份，则必须创建MongoDB Ops Manager组织，生成编程API密钥，并在secret-storage-tool中创建密钥。 这些活动遵循“为Kubernetes Operator 创建凭证”页面上的先决条件和过程。

可选：使用ConfigMap创建项目。

如果已启用备份，请按照使用 ConfigMap 为每个MongoDB部署创建一个项目页面上的先决条件和过程创建项目。

您必须设立ConfigMap 中的 data.baseUrl 设置为MongoDB Ops Manager应用程序的URL 。 要查找此URL ，请调用以下命令：

kubectl get om -o yaml -w

该命令在status.opsManager.url字段中返回 Ops Manager 应用程序的 URL，与以下示例类似：

 status:
   applicationDatabase:
     lastTransition: "2022-04-01T10:00:32Z"
     members: 3
     phase: Running
     type: ReplicaSet
     version: "8.0.0-ubi8"
  backup:
   lastTransition: "2022-04-01T09:57:42Z"
   message: The MongoDB object <namespace>/<oplogresourcename>
     doesn't exist
   phase: Pending
   opsManager:
     lastTransition: "2022-04-01T09:57:40Z"
     phase: Running
     replicas: 1
     url: http://om-svc.cloudqa.svc.cluster.local:8080
     version: "8.0.0"

可选：部署MongoDB 数据库资源以完成备份配置。

如果已启用 备份 ，请为 和快照存储创建MongoDB database oplog资源以完成配置。

1. 在与 Ops Manager 资源相同的命名空间中为 oplog 存储部署MongoDB database资源。

   注意

   创建此数据库作为副本集。

   将资源的metadata.name与您在 Ops Manager 资源定义中指定的spec.backup.opLogStores.mongodbResourceRef.name进行匹配。

2. 选择以下选项之一：

   1. 在与MongoDB database 资源相同的命名空间中部署块存储的MongoDB Ops Manager 资源。

      将资源的metadata.name与您在 Ops Manager 资源定义中指定的spec.backup.blockStores.mongodbResourceRef.name进行匹配。

   2. 配置S 3存储桶以用作S 3快照存储。

      确保您可以使用您在 3MongoDB Ops Manager资源定义中指定的详细信息访问权限 S 存储桶。

可选：确认MongoDB Ops Manager资源正在运行。

如果已启用备份，请通过调用以下命令检查MongoDB Ops Manager资源的状态：

kubectl get om -o yaml -w

当MongoDB Ops Manager正在运行时，该命令会在 status字段下返回以下输出：

status:
  applicationDatabase:
    lastTransition: "2022-04-01T10:00:32Z"
    members: 3
    phase: Running
    type: ReplicaSet
    version: "8.0.0-ubi8"
  backup:
    lastTransition: "2022-04-01T10:00:53Z"
    phase: Running
    version: "8.0.0-ubi8"
  opsManager:
    lastTransition: "2022-04-01T10:00:34Z"
    phase: Running
    replicas: 1
    url: http://om-svc.cloudqa.svc.cluster.local:8080
    version: "8.0.0"

有关资源部署状态的信息，请参阅排除 Kubernetes 操作符故障。