Implementar un recurso de Ops Manager

Configura kubectl para que se ajuste por defecto a tu espacio de nombres.

Si aún no lo ha hecho, ejecute el siguiente comando para ejecutar todos los comandos de kubectl en el namespace 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 sus opciones para el almacenamiento de secretos, consulte Configurar almacenamiento de secretos.

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. Ejecuta el siguiente comando para crear una nueva clave secreta 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 personalizados de CA.

Si el certificado TLS de Ops Manager está firmado por una CA personalizada, el certificado de la CA también debe contener certificados adicionales que permitan que el daemon de copias de seguridad de Ops Manager descargue los binarios de MongoDB desde Internet. Para crear los TLS certificados, cree un ConfigMap para conservar el CA certificado :

1. Obtener toda la cadena de certificados TLS para Ops Manager de downloads.mongodb.com. El siguiente comando openssl genera el certificado en el eslabón hacia el directorio actual de trabajo, en formato .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. 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

   Nota

   • Reemplace el marcador de posición <custom_ca_cert.pem> con su archivo PEM de certificado CA personalizado.

   • No incluyas tu archivo cert1.crt, ya que es tu certificado de servidor de MongoDB que no deberías incluir.

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

Cambia la configuración para que coincida con la configuración de tu Ops Manager y 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
...

Abre tu editor de texto preferido y pega la especificación del objeto en un archivo de texto nuevo.

Configura los ajustes específicos para tu implementación.

Opcional: configura la configuración de copia de seguridad.

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

• Elige configurar un almacenamiento de snapshot de S3 o un almacenamiento en bloques. Si implementas tanto una S3 almacenamiento de snapshot como un almacenamiento en bloques, Ops Manager elegirá uno al azar para realizar la copia de seguridad.

• Elija configurar un almacén de Oplog o un almacén de Oplog S3. Si implementa tanto un almacén oplog como un almacén oplog S3, Ops Manager elige uno al azar para usarlo en la copia de seguridad del oplog.

También debe configurar un almacenamiento de snapshot S3 o un almacenamiento en 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 almacenamiento de snapshot, configura las siguientes opciones:

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

Opcional: configure cualquier ajuste adicional para una copia de seguridad de Ops Manager.

Agrega cualquier configuración opcional para copias de seguridad que quieras aplicar a tu implementación en el archivo de especificaciones de objeto. Por ejemplo, para cada tipo de almacén de copias de seguridad y para los procesos de daemon de copias de seguridad de Ops Manager, puedes asignar etiquetas para asociar almacenes de copias de seguridad concretos o procesos de daemon de copias de seguridad con Proyectos específicos. Utilice spec.backup.[*].assignmentLabels elementos de los recursos de OpsManager.

Opcional: Configure cualquier ajuste adicional para una implementación de Ops Manager.

Agrega cualquier configuración opcional que desees aplicar a tu implementación en el Archivo de Especificación de objetos.

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

Crea tu 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-kubernetes/master/public/samples/ops-manager/ops-manager-external.yaml

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

Para comprobar el estado de tu recurso Ops Manager, ejecuta 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. Ops Manager.

3. Apoyo.

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

Cuando el recurso de Ops Manager completa la fase Pending, el comando devuelve una salida similar a la siguiente en el campo status si habilitaste 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.

Tras completar la fase Pending del recurso, el comando devuelve una salida similar a la siguiente bajo 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 que tomes varían según cómo estés dirigiendo el tráfico a la aplicación de Ops Manager en Kubernetes. Si configuraste el operador de Kubernetes para que cree un servicio de Kubernetes para ti, o creaste un servicio de Kubernetes manualmente, utiliza 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.

Crea credenciales para el operador de Kubernetes.

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

Cree un proyecto utilizando un ConfigMap.

Para crear un Proyecto, sigue los requisitos previos y el procedimiento en la página Crear un Proyecto por cada implementación de MongoDB mediante 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, consulta Gestión de implementaciones externas de MongoDB.

• Establece data.sslMMSCAConfigMap con el nombre de tu ConfigMap que contenga el certificado raíz CA utilizado para firmar el certificado del host de Ops Manager. El Kubernetes operador requiere que asigne a este recurso de Ops Manager el nombre del certificado 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 copia de seguridad. Crea un recurso de base de datos de MongoDB para los almacenes de oplog y de almacenamientos de snapshot para completar la configuración.

1. Despliegue un recurso de base de datos MongoDB para el almacén oplog en el mismo namespace que el recurso Ops Manager.

   Nota

   Cree esta base de datos como un conjunto de réplicasde tres nodos.

   Haz coincidir el metadata.name del recurso con el spec.backup.opLogStores.mongodbResourceRef.name que especificaste en la definición de tu recurso en el administrador de operaciones (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

   Coincide el metadata.name del recurso con el spec.backup.s3Stores.mongodbResourceRef.name que especificaste en tu definición de recurso de Ops Manager.

Confirma que el recurso de Ops Manager esté en funcionamiento.

Para comprobar el estado de tu recurso Ops Manager, ejecuta 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.

Configura kubectl para que se ajuste por defecto a tu espacio de nombres.

Si aún no lo ha hecho, ejecute el siguiente comando para ejecutar todos los comandos de kubectl en el namespace 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
...

Abre tu editor de texto preferido y pega la especificación del objeto en un archivo de texto nuevo.

Configura los ajustes incluidos en el ejemplo anterior.

Opcional: Configure los ajustes de copia de seguridad.

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

• Elige configurar un almacenamiento de snapshot de S3 o un almacenamiento en bloques. Si implementas tanto una S3 almacenamiento de snapshot como un almacenamiento en bloques, Ops Manager elegirá uno al azar para realizar la copia de seguridad.

• Elija configurar un almacén de Oplog o un almacén de Oplog S3. Si implementa tanto un almacén oplog como un almacén oplog S3, Ops Manager elige uno al azar para usarlo en la copia de seguridad del oplog.

También debes configurar un almacenamiento de snapshot S3 o un almacenamiento en bloques. Si implementas tanto una S3 almacenamiento de snapshot como un almacenamiento en bloques, Ops Manager selecciona aleatoriamente uno para usar en la copia de seguridad.

Para configurar un S3 almacenamiento de snapshot, configura los siguientes ajustes:

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

Opcional: configure cualquier ajuste 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 ajuste adicional para una implementación de Ops Manager.

Agrega cualquier configuración opcional que desees aplicar a tu implementación en el Archivo de Especificación de objetos.

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

Crea tu 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-kubernetes/master/public/samples/ops-manager/ops-manager-external.yaml

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

Para comprobar el estado de tu recurso Ops Manager, ejecuta el siguiente comando:

kubectl get om -o yaml -w

El comando devuelve una salida similar a la siguiente, bajo el 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. Ops Manager.

3. Apoyo.

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

Después de que el recurso Ops Manager complete la fase Pending, el comando devuelve una salida similar a la siguiente en el campo status si ha habilitado 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 que tomes varían según cómo estés dirigiendo el tráfico a la aplicación de Ops Manager en Kubernetes. Si configuraste el operador de Kubernetes para que cree un servicio de Kubernetes para ti, o creaste un servicio de Kubernetes manualmente, utiliza 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: Crea credenciales para el operador de Kubernetes.

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

Opcional: Crear un proyecto utilizando un ConfigMap.

Si activaste la copia de seguridad, crea un proyecto siguiendo los requisitos previos y el procedimiento en la página Crear un proyecto por cada 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. Despliegue un recurso de base de datos MongoDB para el almacén oplog en el mismo namespace que el recurso Ops Manager.

   Nota

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

   Haz coincidir el metadata.name del recurso con el spec.backup.opLogStores.mongodbResourceRef.name que especificaste en la definición de tu recurso en el administrador de operaciones (Ops Manager).

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

      Coincide el metadata.name del recurso con el spec.backup.blockStores.mongodbResourceRef.name que especificaste en tu definición de recurso de Ops Manager.

   2. Configura un bucket S3 para usarlo como el almacenamiento de snapshot S3.

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

Opcional: confirmar que el recurso de Ops Manager está en ejecución.

Si activaste la copia de seguridad, verifica el estado de tu recurso Ops Manager ejecutando 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.