部署 Ops Manager 资源

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

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

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

为证书创建密钥。

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

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

1. 获得 TLS 证书和私钥后，运行以下命令以创建 密钥 存储 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 cert1.crt cert2.crt cert3.crt cert4.crt  >> mms-ca.crt

3. 创建 ConfigMap 对于MongoDB Ops Manager ：

   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: "6.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. Name of the ConfigMap file
36
                       # containing the certicate authority that
37
                       # signs the certificates used by the
38
                       # application database.
39
40
...

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: "6.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. Name of the ConfigMap file
42
                       # containing the certicate authority that
43
                       # signs the certificates used by the
44
                       # application database.
45
46
...

打开您首选的文本编辑器并粘贴 对象 规范写入新的文本文件。

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

可选：配置备份设置。

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

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

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

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

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

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

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

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

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

可选：为 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-enterprise-kubernetes/master/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: "6.0.5-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: "6.0.17"

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

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

status:
  applicationDatabase:
     lastTransition: "2022-12-06T18:23:22Z"
     members: 3
     phase: Running
     type: ReplicaSet
     version: "6.0.5-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 操作符 创建档案。

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

使用 ConfigMap 创建项目 。

要创建项目，请遵循使用 ConfigMap 创建一个项目页面上的先决条件和步骤进行操作。

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

• 将 ConfigMap 中的data.baseUrl设置为 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: "6.0.5-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 的名称 包含用于签署 Ops Manager 主机证书的根 CA 证书。 Kubernetes Operator 要求您在mms-ca.crt ConfigMap 中将此 Ops Manager 资源的证书命名为 。

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

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

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

   注意

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

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

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

   注意

   创建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: "6.0.5-ubi8"
  opsManager:
    lastTransition: "2022-12-06T17:46:32Z"
    phase: Running
    replicas: 1
    url: https://om-backup-svc.dev.svc.cluster.local:8443
    version: "6.0.17"

有关资源部署状态的信息，请参阅排除 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: "6.0.5-ubi8"
26
27
...

打开您首选的文本编辑器并粘贴 对象 规范写入新的文本文件。

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

可选：配置备份设置。

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

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

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

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

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

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

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

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

可选：为 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-enterprise-kubernetes/master/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: "6.0.5-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: "6.0.17"

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

访问 Ops Manager 应用程序。

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

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

可选：为 Kubernetes 操作符 创建档案。

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

可选：使用 ConfigMap 创建项目 。

如果已启用备份，请按照使用 ConfigMap 创建一个项目页面上的前提条件和步骤创建项目。

您必须在 ConfigMap 中将data.baseUrl设置为 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: "6.0.5-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: "6.0.17"

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

如果已启用 备份 ，请为 和快照存储创建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快照存储。

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

可选：确认 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: "6.0.5-ubi8"
  backup:
    lastTransition: "2022-04-01T10:00:53Z"
    phase: Running
    version: "6.0.5-ubi8"
  opsManager:
    lastTransition: "2022-04-01T10:00:34Z"
    phase: Running
    replicas: 1
    url: http://om-svc.cloudqa.svc.cluster.local:8080
    version: "6.0.17"

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