Implementar un recurso de Ops Manager

Configure para kubectl que el valor predeterminado sea su espacio de nombres.

Si aún no lo ha hecho, ejecute el siguiente comando para ejecutar todos los kubectl comandos en el espacio de nombres que creó.

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

Crea secretos para tus certificados.

Si utilizas HashiCorp Vault como tu herramienta de almacenamiento secreto, puedes crear un secreto de Vault en su lugar.

Para conocer más sobre sus opciones de almacenamiento secreto,consulte Configurar almacenamiento secreto.

1. Una vez que tenga sus certificados TLS y claves privadas, ejecute el siguiente comando para crear un secreto que almacene el certificado TLS de Ops Manager:

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

2. Ejecute el siguiente comando para crear un nuevo secreto que almacene el certificado TLS de la base de datos de la aplicación:

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

Agregue certificados adicionales a los certificados CA personalizados.

Si su certificado TLS de Ops Manager está firmado por una CA personalizada, este certificado también debe contener certificados adicionales que permitan al Daemon de Copia de Seguridad de Ops Manager descargar binarios de MongoDB de internet. Para crear los certificados TLS, cree un ConfigMap que contenga el certificado de la CA:

1. Obtenga la cadena completa de certificados TLS para Ops Manager downloads.mongodb.com desde. El siguiente openssl comando envía el certificado de la cadena a su directorio de trabajo actual, en .crt formato:

   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. Concatena el archivo de certificado de la CA para Ops Manager con toda la cadena de certificados TLS de downloads.mongodb.com que se obtuvo en el paso anterior:

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

1. Cree el ConfigMap para Ops Manager:

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

Copie uno de los siguientes ejemplos de objetos de Kubernetes de Ops Manager.

Cambie la configuración para que coincida con su Ops Manager y la configuración de la base de datos de la aplicación.

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
...

Abra su editor de texto preferido y pegue la especificación del objeto en un nuevo archivo de texto.

Configure los ajustes específicos para su implementación.

Opcional: configurar los ajustes de copia de seguridad.

Para configurar la copia de seguridad, debes habilitarla y luego:

• Elija configurar un almacén de instantáneas S3 o un almacén de bloques. Si implementa tanto un almacén de instantáneas S3como un almacén de bloques, Ops Manager elige aleatoriamente uno para la copia de seguridad.

• Elija configurar un almacén de registros de operaciones o un 3 almacén de registros de operaciones S. Si implementa tanto un almacén de registros de operaciones como uno 3 S, Ops Manager seleccionará aleatoriamente uno de ellos para la copia de seguridad de registros de operaciones.

También debe configurar un almacén de instantáneas S3 o un almacén de bloques.

Si implementa un almacén de instantáneas S3 y un almacén de bloques, Ops Manager elige aleatoriamente uno para utilizarlo como respaldo.

Para configurar un almacén de instantáneas, configure los siguientes ajustes:

Para configurar un almacén de bloques, configure los siguientes ajustes:

Opcional: configure cualquier configuración adicional para una copia de seguridad de Ops Manager.

Agregue al archivo de especificación de objetos cualquier configuración opcional para las copias de seguridad que desee aplicar a su implementación. Por ejemplo, para cada tipo de almacén de copias de seguridad y para los procesos del demonio de copias de seguridad de Ops Manager, puede asignar etiquetas para asociar almacenes de copias de seguridad o procesos del demonio de copias de seguridad específicos con proyectos específicos. Utilice spec.backup.[*].assignmentLabels los elementos de los recursos de OpsManager.

Opcional: configure cualquier configuración adicional para una implementación de Ops Manager.

Agregue cualquier configuración opcional que desee aplicar a su implementación al archivo de especificación de objeto.

Guarde este archivo con una .yaml extensión de archivo.

Cree su instancia de Ops Manager.

Ejecute el siguiente comando kubectl en el nombre de archivo de la definición de recurso de Ops Manager:

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

Realice un seguimiento del estado de su instancia de Ops Manager.

Para comprobar el estado de su recurso Ops Manager, invoque el siguiente comando:

kubectl get om -o yaml -w

El comando devuelve una salida similar a la siguiente en el campo status mientras se implementa el recurso:

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

El operador de Kubernetes concilia los recursos en el siguiente orden:

1. Base de datos de la aplicación.

2. Gerente de operaciones.

3. Apoyo.

El operador de Kubernetes no reconcilia un recurso hasta que el anterior entre en la fase Running.

Una vez que el recurso Ops Manager completa la fase Pending, el comando devuelve un resultado similar al siguiente en el campo status si habilitó la Copia de seguridad:

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"

La copia de seguridad permanece en un estado Pending hasta que configure las bases de datos de copia de seguridad.

Una vez que el recurso completa la fase Pending, el comando devuelve una salida similar a la siguiente en el campo 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: ""

La copia de seguridad permanece en un estado Pending hasta que configure las bases de datos de copia de seguridad.

Acceda a la aplicación Ops Manager.

Los pasos a seguir varían según cómo se enrute el tráfico a la aplicación Ops Manager en Kubernetes. Si configuró el operador de Kubernetes para que creara un servicio de Kubernetes automáticamente o si lo creó manualmente, utilice uno de los siguientes métodos para acceder a la aplicación Ops Manager:

Para saber cómo acceder a la aplicación Ops Manager mediante un servicio de terceros, consulte la documentación de su solución.

Cree credenciales para el operador de Kubernetes.

Para configurar las credenciales, debe crear una organización de Ops Manager, generar claves de API programáticas y crear un secreto. Estas actividades siguen los requisitos previos y el procedimiento descritos en la página "Crear credenciales para el operador de Kubernetes".

Cree un proyecto utilizando un ConfigMap.

Para crear un proyecto, siga los requisitos previos y el procedimiento de la página Crear un proyecto por implementación de MongoDB usando un ConfigMap.

Establezca los siguientes campos en el ConfigMap de su proyecto:

• Establezca data.baseUrl en el ConfigMap como la URL de la aplicación Ops Manager. Para encontrar esta URL, ejecute el siguiente comando:

  kubectl get om -o yaml -w

  El comando devuelve la URL de la aplicación Ops Manager en el campo status.opsManager.url, similar al siguiente ejemplo:

  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: ""

  Importante

  Si implementa Ops Manager con el operador de Kubernetes y Ops Manager administrará los recursos de la base de datos MongoDB implementados fuera del clúster de Kubernetes en el que está implementado, debe establecer data.baseUrl con el mismo valor de la spec.configuration.mms.centralUrl configuración en la especificación de recursos de Ops Manager.

  Para obtener más información,consulte Administrar implementaciones externas de MongoDB.

• Establezca data.sslMMSCAConfigMap con el nombre de su ConfigMap que contiene el certificado de CA raíz utilizado para firmar el certificado del host de Ops Manager. El operador de Kubernetes requiere que el certificado de este recurso de Ops Manager se nombre mms-ca.crt en el ConfigMap.

Implementa recursos de bases de datos MongoDB para completar la configuración de copia de seguridad.

De forma predeterminada, Ops Manager habilita la copia de seguridad. Cree un recurso de base de datos MongoDB para los almacenes de registros de operaciones e instantáneas para completar la configuración.

1. Implemente un recurso de base de datos MongoDB para el almacén de registros de operaciones en el mismo espacio de nombres que el recurso Ops Manager.

   Nota

   Cree esta base de datos como un conjunto de réplicas de tres miembros.

   Haga coincidir el metadata.name del recurso con el spec.backup.opLogStores.mongodbResourceRef.name que especificó en la definición de recurso de Ops Manager.

2. Implementar un recurso de base de datos MongoDB para el almacenamiento de snapshot S3 en el mismo namespace que el recurso Ops Manager.

   Nota

   Cree el almacén de instantáneas S como un conjunto de réplicas.3

   Haga coincidir el metadata.name del recurso con el spec.backup.s3Stores.mongodbResourceRef.name que especificó en la definición de recurso de Ops Manager.

Confirme que el recurso Ops Manager se esté ejecutando.

Para comprobar el estado de su recurso Ops Manager, invoque el siguiente comando:

kubectl get om -o yaml -w

Cuando se ejecuta Ops Manager, el comando devuelve una salida similar a la siguiente, debajo del campo 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"

Consulte Solucionar problemas del operador de Kubernetes para obtener información sobre los estados de implementación de recursos.

Configure para kubectl que el valor predeterminado sea su espacio de nombres.

Si aún no lo ha hecho, ejecute el siguiente comando para ejecutar todos los kubectl comandos en el espacio de nombres que creó.

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

Copie uno de los siguientes ejemplos de objetos de Kubernetes de Ops Manager.

Cambie la configuración para que coincida con su configuración de 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
...

Abra su editor de texto preferido y pegue la especificación del objeto en un nuevo archivo de texto.

Configure los ajustes incluidos en el ejemplo anterior.

Opcional: Configure los ajustes de copia de seguridad.

Para configurar la copia de seguridad, debes habilitarla y luego:

• Elija configurar un almacén de instantáneas S3 o un almacén de bloques. Si implementa tanto un almacén de instantáneas S3como un almacén de bloques, Ops Manager elige aleatoriamente uno para la copia de seguridad.

• Elija configurar un almacén de registros de operaciones o un 3 almacén de registros de operaciones S. Si implementa tanto un almacén de registros de operaciones como uno 3 S, Ops Manager seleccionará aleatoriamente uno de ellos para la copia de seguridad de registros de operaciones.

También debe configurar un almacén de instantáneas S3 o un almacén de bloques. Si implementa tanto un almacén de instantáneas S3como un almacén de bloques, Ops Manager elige aleatoriamente uno para la copia de seguridad.

Para configurar un 3 almacén de instantáneas S, configure los siguientes ajustes:

Para configurar un almacén de bloques, configure los siguientes ajustes:

Opcional: configure cualquier configuración adicional para una copia de seguridad de Ops Manager.

Agregue al archivo de especificación de objetos cualquier configuración opcional para las copias de seguridad que desee aplicar a su implementación. Por ejemplo, para cada tipo de almacén de copias de seguridad y para los procesos del demonio de copias de seguridad de Ops Manager, puede asignar etiquetas para asociar almacenes de copias de seguridad o procesos del demonio de copias de seguridad específicos con proyectos específicos. Utilice spec.backup.[*].assignmentLabels los elementos de los recursos de OpsManager.

Opcional: configure cualquier configuración adicional para una implementación de Ops Manager.

Agregue cualquier configuración opcional que desee aplicar a su implementación al archivo de especificación de objeto.

Guarde este archivo con una .yaml extensión de archivo.

Cree su instancia de Ops Manager.

Ejecute el siguiente comando kubectl en el nombre de archivo de la definición de recurso de Ops Manager:

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

Realice un seguimiento del estado de su instancia de Ops Manager.

Para comprobar el estado de su recurso Ops Manager, invoque el siguiente comando:

kubectl get om -o yaml -w

El comando devuelve un resultado similar al siguiente, debajo del campo status mientras se implementa el recurso:

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

El operador de Kubernetes concilia los recursos en el siguiente orden:

1. Base de datos de la aplicación.

2. Gerente de operaciones.

3. Apoyo.

El operador de Kubernetes no reconcilia un recurso hasta que el anterior entre en la fase Running.

Una vez que el recurso Ops Manager completa la fase Pending, el comando devuelve una salida similar a la siguiente en el campo status si habilitó la copia de seguridad:

 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"

La copia de seguridad permanece en el estado Pending hasta que configures las bases de datos de copia de seguridad.

Acceda a la aplicación Ops Manager.

Los pasos a seguir varían según cómo se enrute el tráfico a la aplicación Ops Manager en Kubernetes. Si configuró el operador de Kubernetes para que creara un servicio de Kubernetes automáticamente o si lo creó manualmente, utilice uno de los siguientes métodos para acceder a la aplicación Ops Manager:

Para saber cómo acceder a la aplicación Ops Manager mediante un servicio de terceros, consulte la documentación de su solución.

Opcional: cree credenciales para el operador de Kubernetes.

Si habilitó la copia de seguridad, debe crear una organización de Ops Manager, generar claves de API programáticas y crear un secreto en su herramienta de almacenamiento de secretos. Estas actividades siguen los requisitos previos y el procedimiento descritos en la página "Crear credenciales para el operador de Kubernetes".

Opcional: crea un proyecto usando un ConfigMap.

Si habilitó la copia de seguridad, cree un proyecto siguiendo los requisitos previos y el procedimiento de la página Crear un proyecto por implementación de MongoDB usando un ConfigMap.

Debes configurar en el data.baseUrl ConfigMap como la URL de la aplicación Ops Manager. Para encontrar esta URL, ejecuta el siguiente comando:

kubectl get om -o yaml -w

El comando devuelve la URL de la aplicación Ops Manager en el campo status.opsManager.url, similar al siguiente ejemplo:

 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"

Opcional: Implemente recursos de base de datos MongoDB para completar la configuración de la copia de seguridad.

Si habilitó Copia de seguridad, cree un recurso de base de datos MongoDB para oplog y almacenamiento de snapshot para completar la configuración.

1. Implemente un recurso de base de datos MongoDB para el almacén de registros de operaciones en el mismo espacio de nombres que el recurso Ops Manager.

   Nota

   Cree esta base de datos como un conjunto de réplicas.

   Haga coincidir el metadata.name del recurso con el spec.backup.opLogStores.mongodbResourceRef.name que especificó en la definición de recurso de Ops Manager.

2. Elija una de las siguientes opciones:

   1. Implemente un recurso de base de datos MongoDB para el almacén de bloques en el mismo espacio de nombres que el recurso Ops Manager.

      Haga coincidir el metadata.name del recurso con el spec.backup.blockStores.mongodbResourceRef.name que especificó en la definición de recurso de Ops Manager.

   2. Configure un depósito S para3 utilizarlo como3 almacén de instantáneas S.

      Asegúrese de poder acceder al depósito S3 utilizando los detalles que especificó en la definición de recurso de Ops Manager.

Opcional: Confirme que el recurso Ops Manager se esté ejecutando.

Si habilitó la copia de seguridad, verifique el estado de su recurso Ops Manager invocando el siguiente comando:

kubectl get om -o yaml -w

Cuando se ejecuta Ops Manager, el comando devuelve la siguiente salida en el campo 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"

Consulte Solucionar problemas del operador de Kubernetes para obtener información sobre los estados de implementación de recursos.