Especificación de Ops Manager de recursos

Configuración de conectividad externa

Esta sección describe la configuración opcional relacionada con la conectividad externa en Ops Manager. Para la configuración opcional de conectividad externa específica de su implementación multiclúster de Ops Manager, consulte Configuración multiclúster.

spec.externalConnectivity

tipo: colección

Objeto de configuración que habilita la conectividad externa a Ops Manager. Si se proporciona, el operador de Kubernetes crea un servicio de Kubernetes que permite que el tráfico proveniente del exterior del clúster de Kubernetes llegue a la aplicación Ops Manager.

Si no se proporciona, el operador de Kubernetes no crea un servicio de Kubernetes. Debe crear uno manualmente o utilizar una solución de terceros que le permita enrutar el tráfico externo a la aplicación Ops Manager en su clúster de Kubernetes.

spec.externalConnectivity.type

Tipo: string

El servicio de Kubernetes ServiceType que expone Ops Manager fuera de Kubernetes.

Required if spec.externalConnectivity.type is present.

Los valores aceptados son: LoadBalancer y NodePort. Se recomienda LoadBalancer si su proveedor de nube lo admite. Utiliza NodePort para implementaciones locales.

spec.externalConnectivity.port

Tipo: entero

Valor que indica qué puerto que un servicio de Kubernetes expone debe usar la Aplicación Ops Manager para el tráfico externo.

• If spec.externalConnectivity.type is NodePort:

  • El servicio Kubernetes expone la aplicación Ops Manager al tráfico externo a través de este puerto.

  • If you don't provide a spec.externalConnectivity.port value, the Kubernetes service routes traffic to the Ops Manager Application from an available port selected randomly from the following default range: 30000-32767.

    Nota

    Debes configurar el firewall de tu red para permitir el tráfico a través de este puerto.

• If spec.externalConnectivity.type is LoadBalancer:

  • El recurso de balanceador de carga que crea el proveedor de nube expone la aplicación de Ops Manager a través de este puerto.

  • Si no proporciona un valor, el servicio Kubernetes expone la aplicación Ops Manager al tráfico externo a spec.externalConnectivity.port través8080 del8443 puerto HTTP () o HTTPS () predeterminado.

spec.externalConnectivity.loadBalancerIP

Tipo: string

La dirección IP que el servicio de Kubernetes LoadBalancer utiliza cuando el Operador de Kubernetes lo crea.

This setting can only be used if your cloud provider supports it and spec.externalConnectivity.type is LoadBalancer. To learn more about the Type LoadBalancer, see the Kubernetes documentation.

spec.externalConnectivity.externalTrafficPolicy

Tipo: string

Política de enrutamiento para el tráfico externo al servicio Kubernetes de Ops Manager. Este servicio dirige el tráfico externo a endpoints locales del nodo o de todo el clúster según el valor de esta configuración.

Los valores aceptados son: Cluster y Local. Para saber cuáles de los valores cumplen tus requisitos, consulta IPs de origen en Kubernetes en la documentación de Kubernetes.

Nota

Si selecciona Cluster, el Source-IP de sus clientes se pierden durante los saltos de red que ocurren en el límite de la red de Kubernetes.

spec.externalConnectivity.annotations

tipo: colección

Pares clave-valor que le permiten proporcionar configuraciones específicas del proveedor de nube.

Para obtener más información sobre anotaciones y Soporte TLS en AWS, consulta la documentación de Kubernetes.

Configuración de copias de seguridad

Esta sección describe la configuración opcional relacionada con las copias de seguridad en Ops Manager. Para la configuración opcional de copias de seguridad específica de su implementación de varios clústeres de Ops Manager, consulta Configuración multi-clúster.

spec.backup.assignmentLabels

Tipo: arreglo de cadenas

Una lista de etiquetas de asignación para los procesos del daemon de copias de seguridad Service. Utiliza etiquetas de asignación para identificar que procesos específicos del daemon de copias de seguridad están asociados con Proyectos particulares. Si configura etiquetas de asignación usando el Operador de Kubernetes, los valores que se establecen en el archivo de configuración de Kubernetes para las etiquetas de asignación anulan los valores definidos en la Interfaz de usuario de Ops Manager. Las etiquetas de asignación que no configures usando el Operador de Kubernetes seguirán utilizando los valores configurados en la interfaz de usuario de Ops Manager.

spec.backup.enabled

Tipo: booleano

Indicador que habilita las copias de seguridad para su recurso de Ops Manager. Cuando se establece en false, la copia de seguridad está deshabilitada.

El valor por defecto es true.

spec.backup.encryption

Tipo: Objeto

Un objeto que contiene la configuración de cifrado de copias de seguridad.

spec.backup.encryption.kmip

Tipo: Objeto

Objeto que contiene la configuración de cifrado de copia de seguridad KMIP. Para obtener más información, consulte Configurar el cifrado de copia de seguridad KMIP para Ops Manager.

Nota

If you set this parameter, the API key linked with the value of spec.credentials must have the Global Owner role.

spec.backup.encryption.kmip.server

Tipo: Objeto

Objeto que contiene la configuración del servidor de cifrado de copia de seguridad KMIP.

spec.backup.encryption.kmip.server.ca

Tipo: string

Etiqueta legible por humanos que identifica el ConfigMap que contiene una entrada para el certificado CA (ca.pem) que se usará para la autenticación KMIP.

spec.backup.encryption.kmip.server.url

Tipo: string

URL para el servidor KMIP que utiliza el formato hostname.port (por ejemplo, 192.168.1.3:5696 o my-kmip-server.mycorp.com:5696).

spec.backup.headDB

tipo: colección

Configuración para la base de datos principal. El Operador de Kubernetes crea una Solicitud de volumen persistente con la configuración especificada.

Escalar	Tipo de dato	Descripción
labelSelector	string	Etiqueta utilizada para vincular volúmenes montados a directorios.
storage	string	Tamaño mínimo de Volumen Persistente que debe montarse. Este valor se expresa como un número entero seguido de una unidad de almacenamiento en notación JEDEC. El valor por defecto es 30Gi. Para obtener más información, consulte Requisitos de hardware del daemon de copia de seguridad. Por ejemplo, si la base de datos principal requiere 60 gigabytes de espacio de almacenamiento, establezca este valor en 60Gi.
storageClass	string	Tipo de almacenamiento especificado en un Reclamo de volumen persistente. Puede crear este tipo de almacenamiento como un objeto StorageClass antes de usarlo en esta especificación de objeto. Make sure to set the StorageClass reclaimPolicy to Retain. This ensures that data is retained when a Persistent Volume Claim is removed.

spec.backup.jvmParameters

Tipo: arreglo de cadenas

Opcional. Parámetros JVM pasados al servicio de copias de seguridad del Ops Manager en el contenedor.

Este parámetro del operador de Kubernetes es por defecto una lista vacía.

spec:
  backup:
    jvmParameters: ["-XX:+UseStringCache"]

Advertencia

Cambiar los valores de Heap de memoria de la JVM bajo tu propio riesgo

El operador de Kubernetes calcula los valores de heap de memoria de la JVM del servicio de copia de seguridad en función de la memoria del contenedor. Cambiar los valores de -Xms y -Xmx puede causar problemas con MongoDB Ops Manager.

spec.backup.members

Tipo: entero

Optional. Number of backup daemon services to deploy in Kubernetes. If not specified, defaults to 1. To ensure high availability for your backup service, deploy multiple backup daemons in Ops Manager.

spec.backup.opLogStores

tipo: colección

Obligatorio si habilitas la copia de seguridad. Array de almacenes oplog utilizados para copias de seguridad. Cada elemento en el arreglo hace referencia a un recurso de base de datos MongoDB desplegado en el clúster de Kubernetes por el operador de Kubernetes.

spec.backup.opLogStores.assignmentLabels

Tipo: arreglo de cadenas

Una lista de etiquetas de tareas para la almacenar oplog. Utiliza etiquetas de asignación para identificar que almacenes específicos de oplog están asociados a proyectos particulares. Si configura etiquetas de asignación usando el Operador de Kubernetes, los valores que se establecen en el archivo de configuración de Kubernetes para las etiquetas de asignación anulan los valores definidos en la Interfaz de usuario de Ops Manager. Las etiquetas de asignación que no configures usando el Operador de Kubernetes seguirán utilizando los valores configurados en la interfaz de usuario de Ops Manager.

spec.backup.opLogStores.name

Tipo: string

Obligatorio si habilitas la Copia de seguridad. Nombre del almacén de oplog.

Importante

Una vez especificado, no edite el nombre del almacenar de oplog.

spec.backup.opLogStores.mongodbResourceRef.name

Tipo: string

Obligatorio si habilitas la Copia de seguridad. Nombre del recurso MongoDB o del recurso MongoDBMultiCluster que se crea para almacenar las secciones de el oplog. Debe implementar este recurso en el mismo namespace que el recurso Ops Manager.

La base de datos Oplog solo admite el mecanismo de autenticación SCRAM. No puedes habilitar otros mecanismos de autenticación.

Si activa la autenticación SCRAM en la base de datos oplog, debe:

• Cree un recurso de usuario de MongoDB para conectar Ops Manager a la base de datos oplog.

• Specify the name of the user in the Ops Manager resource definition.

Si un recurso de base de datos MongoDB con este nombre no existe, el recurso backup entra en el estado Pending. El operador de Kubernetes reintenta cada 10 segundos hasta que se cree un recurso de base de datos MongoDB con este nombre.

Nota

El operador de Kubernetes comienza a conciliar el recurso Ops Manager automáticamente cuando se realizan cambios de seguridad en los recursos de base de datos referenciados en esta configuración. El operador de Kubernetes actualiza los indicadores mongoUri y ssl en la configuración del Ops Manager según tus cambios.

spec.backup.opLogStores.mongodbUserRef.name

Tipo: string

Necesario si la autenticación SCRAM está habilitada en la base de datos del almacén oplog. Nombre del recurso de usuario de MongoDB utilizado para conectarse a la base de datos del almacén oplog. Implementa este recurso de usuario en el mismo namespace que el recurso de Ops Manager y con todos los siguientes roles:

• readWriteAnyDatabase

• dbAdminAnyDatabase

• clusterMonitor

spec.backup.blockStores

tipo: colección

Se requiere si está habilitando la copia de seguridad mediante un almacenamiento en bloques. Arreglo de blockstores utilizados para Copia de seguridad. Cada elemento en el arreglo hace referencia a un recurso de base de datos MongoDB desplegado en el clúster de Kubernetes por el operador de Kubernetes.

spec.backup.blockStores.assignmentLabels

Tipo: arreglo de cadenas

Una lista de etiquetas de asignación para el almacenamiento en bloques. Utiliza etiquetas de asignación para identificar que tiendas de bloques específicos están asociados con proyectos particulares. Si configura etiquetas de asignación usando el Operador de Kubernetes, los valores que se establecen en el archivo de configuración de Kubernetes para las etiquetas de asignación anulan los valores definidos en la Interfaz de usuario de Ops Manager. Las etiquetas de asignación que no configures usando el Operador de Kubernetes seguirán utilizando los valores configurados en la interfaz de usuario de Ops Manager.

spec.backup.blockStores.name

Tipo: string

Se requiere si activa la copia de seguridad utilizando un almacenamiento en bloques. Nombre del almacenamiento en bloques.

Importante

Una vez especificado, no edites el nombre del almacenamiento en bloques.

spec.backup.blockStores.mongodbResourceRef.name

Tipo: string

Obligatorio si se habilita la copia de seguridad utilizando un almacenamiento en bloques. Nombre del recurso de base de datos MongoDB creado para el almacenamiento en bloques. Debe implementar este recurso de base de datos en el mismo namespace que el recurso de Ops Manager.

La base de datos de almacenamiento en bloques solo admite el mecanismo de autenticación SCRAM. No puedes habilitar otros mecanismos de autenticación.

Si habilita la autenticación SCRAM en la base de datos de almacenamiento en bloques, debe:

• Crea un recurso de usuario de MongoDB para conectar Ops Manager a la base de datos de almacenamiento en bloques.

• Specify the name of the user in the Ops Manager resource definition.

Si un recurso de base de datos MongoDB con este nombre no existe, el recurso backup entra en el estado Pending. El operador de Kubernetes reintenta cada 10 segundos hasta que se cree un recurso de base de datos MongoDB con este nombre.

Nota

El operador de Kubernetes comienza a conciliar el recurso Ops Manager automáticamente cuando se realizan cambios de seguridad en los recursos de base de datos referenciados en esta configuración. El operador de Kubernetes actualiza los indicadores mongoUri y ssl en la configuración del Ops Manager según tus cambios.

spec.backup.blockStores.mongodbUserRef.name

Tipo: string

Requerido si la autenticación SCRAM está habilitada en la base de datos de almacenamiento en bloques. Nombre del recurso de usuario de MongoDB utilizado para conectarse a la base de datos de almacenamiento en bloques. Implementa este recurso de usuario en el mismo namespace que el recurso de Ops Manager y con todos los siguientes roles:

• readWriteAnyDatabase

• dbAdminAnyDatabase

• clusterMonitor

spec.backup.queryableBackupSecretRef.name

Tipo: string

Nombre del secreto que contiene el archivo queryable.pem de Ops Manager, que se utilizará para acceder y query copias de seguridad según los requisitos de TLS de la implementación. El archivo PEM contiene un certificado de llave pública y su llave privada asociada, necesarios para acceder y ejecutar queries en snapshots de copias de seguridad en Ops Manager. Para consultar las copias de seguridad, especifica el valor para este parámetro. Si no se establece, las copias de seguridad no se ven afectadas, pero no se puede consultar.

spec.backup.statefulSet.spec

tipo: colección

Especificación para el StatefulSet que los controladores MongoDB para Kubernetes Operator crean para el servicio de daemon de copias de seguridad.

To review which fields you can add to spec.backup.statefulSet.spec, see StatefulSetSpec v1 apps in the Kubernetes documentation.

spec.backup.statefulSet.spec.template

tipo: colección

Plantilla for the Kubernetes Pods in the StatefulSet that the MongoDB Controllers for Kubernetes operador creates for the servicio de daemon de copias de seguridad.

Nota

The Kubernetes Operator doesn't validate the fields you provide in spec.backup.statefulSet.spec.template.

spec.backup.statefulSet.spec.template.metadata

tipo: colección

Metadata para los pods de Kubernetes en el StatefulSet que los controladores de MongoDB para Kubernetes Operator crean para el servicio de daemon de copias de seguridad.

To review which fields you can add to spec.backup.statefulSet.spec.template.metadata, see the Kubernetes documentation.

spec.backup.statefulSet.spec.template.spec

tipo: colección

Especificaciones de los Pods de Kubernetes en el Set Statefull que los controladores de MongoDB para Kubernetes operador crean para el servicio de daemon de copias de seguridad.

To review the complete list of fields you can add to spec.backup.statefulSet.spec.template.spec, see the Kubernetes documentation.

El siguiente ejemplo spec.backup.statefulSet.spec.template.spec define la capacidad mínima y máxima de CPU y memoria para un contenedor daemon de copias de seguridad que los MongoDB Controllers for Kubernetes operador implementan:

Tip

Para obtener más información sobre los requisitos de hardware, software y redes para los hosts que ejecutan los componentes de Ops Manager, consulte Requisitos del sistema de Ops Manager en la Documentación de Ops Manager.

statefulSet:
  spec:
    template:
      spec:
        containers:
        - name: mongodb-backup-daemon
          resources:
            requests:
              cpu: "4"
              memory: "8Gi"
            limits:
              cpu: "8"
              memory: "16Gi"

spec.backup.statefulSet.spec.template.spec.containers

tipo: colección

Lista de contenedores que pertenecen a los Kubernetes Pods en el StatefulSet que crean los controladores de MongoDB para el operador Kubernetes para el daemon de copias de seguridad.

To modify the specifications of the backup daemon service container, you must provide the exact name of the container using the name field, as shown in the following example:

backup:
 statefulSet:
   spec:
     template:
       spec:
         containers:
         - name: mongodb-backup-daemon

Nota

Cuando añades contenedores a spec.backup.statefulSet.spec.template.spec.containers, el Kubernetes operador los agrega al pod de Kubernetes. Estos contenedores se añaden a los contenedores de Servicio del Daemon de Copias de Seguridad en el pod.

spec.backup.statefulSet.spec.template.spec.containers.resources.requests.cpu

Tipo: string

Capacidad mínima de CPU que debe estar disponible en un nodo de Kubernetes para alojar el servicio de daemon de copias de seguridad.

The requested value must be less than or equal to spec.backup.statefulSet.spec.template.spec.containers.resources.limits.cpu.

spec.backup.statefulSet.spec.template.spec.containers.resources.limits.cpu

Tipo: string

Maximum CPU capacity for the node being created to host the backup daemon service. If omitted, this value is set to spec.backup.statefulSet.spec.template.spec.containers.resources.requests.cpu.

spec.backup.statefulSet.spec.template.spec.containers.resources.requests.memory

Tipo: string

Capacidad mínima de memoria que debe estar disponible en un nodo de Kubernetes para alojar el servicio de daemon de copias de seguridad en Kubernetes. Este valor se expresa como un número entero seguido de una unidad de memoria en notación JEDEC.

Nota

Establece este valor en al menos 4.5Gi. Valores menores a 4.5Gi pueden resultar en un error.

The requested value must be less than or equal to spec.backup.statefulSet.spec.template.spec.containers.resources.limits.memory.

spec.backup.statefulSet.spec.template.spec.containers.resources.limits.memory

Tipo: string

Maximum memory capacity for the node being created to host the backup daemon service. If omitted, this value is set to spec.backup.statefulSet.spec.template.spec.containers.resources.requests.memory.

El Operador de Kubernetes calcula y establece los parámetros para el tamaño del heap de Java en función de la memoria del contenedor.

Advertencia

Limitar este valor a menos de 32 GB

Si establece este parámetro en un valor mayor a 32 GB (32Gi), puede causar problemas con el servicio de copia de seguridad. Los montones excesivos pueden causar resultados impredecibles en Ops Manager.

Configuraciones S3

Puede configurar MongoDB Ops Manager para usar S3 para almacenar oplogs y snapshots de copia de seguridad, y proteger las conexiones a S3 con TLS usando claves emitidas por una CA personalizada.

Para configurar llaves de CA personalizadas, utilice el ConfigMap con el que configuró TLS para su base de datos de la aplicación como se describe en la pestaña TLS-Encrypted Connection (HTTPS) de Implementar un recurso de Ops Manager. Establezca spec.applicationDatabase.security.tls.ca en este ConfigMap.

Puede utilizar TLS tanto para S3 como para su base de datos de la aplicación, o solo para S.3

• Para usar TLS para ambos, obtén certificados para ambos propósitos del mismo ca-pem referenciado en el ConfigMap.

• Para usar TLS solo para S3, no defina spec.security.applicationDatabase.certsSecretPrefix en su ConfigMap.

spec.backup.s3OpLogStores.assignmentLabels

Tipo: arreglo de cadenas

Una lista de etiquetas de asignación para almacenes de oplog S3. Utilice etiquetas de asignación para identificar que los almacenes de oplog S3 específicos están asociados a proyectos concretos. Si establece etiquetas de asignación mediante el operador de Kubernetes, los valores que establezca en el archivo de configuración de Kubernetes para las etiquetas de asignación sobrescriben los valores definidos en la Interfaz de usuario de MongoDB Ops Manager. Las etiquetas de asignación que no establezca mediante el operador de Kubernetes continúan utilizando los valores establecidos en la Interfaz de usuario de MongoDB Ops Manager.

spec.backup.s3OpLogStores.customCertificate

Tipo: booleano

Deprecated. Use spec.backup.s3OpLogStores.customCertificateSecretRefs instead.

Indicador que determina si utilizas certificados de AppDB (appdb-ca) como el certificado TLS personalizado para tu almacén de oplog de S3. El valor por defecto es False.

spec.backup.s3OpLogStores.customCertificateSecretRefs

Tipo: arreglo de objetos

Lista de certificados personalizados para su almacén de oplog S3 utilizando secretos de Kubernetes. El certificado x.509 codificado en base64ya debe estar presente en un secreto de Kubernetes con una clave y debe ser analizable por la Java CertifcateFactory. No puede especificar varios certificados en una cadena en un secreto. Si especifica varios certificados en una cadena en un secreto, el operador de Kubernetes utiliza solo el primer certificado de la cadena. Si también proporciona la configuración customCertificate, el operador de Kubernetes utiliza la spec.applicationDatabase.security.tls.ca como certificado personalizado para las copias de seguridad.

Each entry in the list specifies the name and the key. If you specify multiple secrets, Kubernetes Operator uses all the certificates in the specified secrets.

Si no proporcionas esta configuración, Ops Manager usa el JVM almacén de confianza por defecto utilizado por Ops Manager.

spec.backup.s3OpLogStores.customCertificateSecretRefs.name

Tipo: string

Requerido para utilizar certificados personalizados para tu S3 tienda de Oplog. Secreto de Kubernetes secret que contiene el certificado personalizado.

spec.configuration.mms.mongoDbUsage.defaultUsageType

Tipo: string

El tipo de servidor por defectodel servicio de Kubernetes.

spec.backup.s3OpLogStores.customCertificateSecretRefs.key

Tipo: string

Requerido para utilizar certificados personalizados para su S3 oplog store. Archivo que representa la clave en el secreto que contiene el certificado x.509 codificado en base64. Si no especificas esta configuración, el Operador de Kubernetes no puede utilizar el certificado personalizado para las copias de seguridad del almacén oplog de S3.

spec.backup.s3OpLogStores.irsaEnabled

Tipo: booleano

Marca que permite usar los AWS roles de IAM para cuentas de servicio en AWS EKS para configurar un almacenamiento de oplog S.3 El valor por defecto es False. Si no utiliza AWS EKS, esta marca no tiene ningún efecto. Cuando se establece False en, el uso de los AWS roles de IAM para cuentas de servicio en EKS para configurar un almacenamiento de oplog S está deshabilitado.3 Para obtener más información, consulte IAM roles for service accounts in EKS.

spec.backup.s3OpLogStores.name

Tipo: string

Es necesario almacenar el oplog utilizando un almacenamiento S.3 Nombre del 3 almacén de oplog S.

spec.backup.s3OpLogStores.mongodbResourceRef.name

Tipo: string

Nombre del recurso de base de datos de MongoDB que cree para almacenar metadatos para el almacén de oplog S3. Debe implementar este recurso de base de datos en el mismo namespace que el recurso de MongoDB Ops Manager.

Nota

Omita esta configuración para utilizar la base de datos de la aplicación para almacenar metadatos para el almacén de oplog S.3

If you omit this setting, you must also omit the spec.backup.s3OpLogStores.mongodbUserRef.name setting. The Kubernetes Operator handles SCRAM user authentication internally.

Si habilitas la autenticación SCRAM en esta base de datos, debes:

• Crea un recurso de usuario de MongoDB para conectar Ops Manager a la base de datos.

• Specify the name of the user in the Ops Manager resource definition.

spec.backup.s3OpLogStores.mongodbUserRef.name

Tipo: string

Se requiere si creaste un recurso de base de datos MongoDB para almacenar metadatos de S3 oplog y SCRAM está habilitado en esta base de datos. Nombre del recurso de usuario de MongoDB utilizado para conectarse a la base de datos de metadatos del almacenamiento de oplog S3. Implementa este recurso de usuario en el mismo namespace que el recurso de MongoDB Ops Manager y con todos los siguientes roles:

• readWriteAnyDatabase

• dbAdminAnyDatabase

• clusterMonitor

Importante

Una vez especificado, no edite el nombre del nombre de usuario del almacenar de oplog de metadatos de S3.

spec.backup.s3OpLogStores.s3SecretRef.name

Tipo: string

Obligatorio para guardar el oplog utilizando un almacén S3 si spec.backup.s3OpLogStores.irsaEnabled no está configurado en true.

Nombre del secreto que contiene los campos accessKey y secretKey. El servicio de daemon de copias de seguridad utiliza los valores de estos campos como credenciales para acceder a tu bucket compatible con AWS S3 o S3. Para configurar el almacenamiento de oplog S3, debe especificar ambas claves en el secreto.

Si configuras spec.backup.s3OpLogStores.irsaEnabled como true, no necesitas configurar s3SecretRef, porque las credenciales de AWS S3 se montan como variables de entorno del pod.

spec.backup.s3OpLogStores.pathStyleAccessEnabled

Tipo: booleano

Indica el estilo de la URL del endpoint del bucket.

Valor	Descripción	Ejemplo
true	URL con estilo de ruta	s3.amazonaws.com/<bucket>
false	URL con estilo de host virtual	<bucket>.s3.amazonaws.com

Para aprender más sobre anotaciones y el soporte de TLS en AWS, consulte la documentación de Kubernetes.

El valor por defecto es true.

spec.backup.s3OpLogStores.s3BucketEndpoint

Tipo: string

Es necesario almacenar el oplog utilizando un almacenamiento S3. URL del bucket Amazon Web Services S3 o del bucket compatible con S3que aloja el almacén de oplog.

Nota

Si su endpoint no incluye una región en su URL, especifique el campo s3RegionOverride.

spec.backup.s3OpLogStores.s3BucketName

Tipo: string

Es necesario almacenar el oplog utilizando un almacenamiento S3. Nombre del bucket S3 de AWS o del bucket compatible con S3que aloja el almacén de oplog.

spec.backup.s3OpLogStores.s3RegionOverride

Tipo: string

Región donde reside su bucket compatible con S3. Utilice este campo únicamente si su S3 oplog del almacenar s3BucketEndpoint no admite el alcance de la región. El alcance de la región es cuando su endpoint no incluye una región en su URL.

No utilice este campo con los cubos de Amazon Web Services S.3 Para obtener más información, consulte la Configuración de almacenamiento en bloques S3.

spec.backup.s3Stores.assignmentLabels

Tipo: arreglo de cadenas

Una lista de etiquetas de asignación para los buckets compatibles con S3 o S3donde se almacenan las snapshots de copia de seguridad de la base de datos. Utiliza etiquetas de asignación para identificar que los almacenes S3 específicos están asociados a proyectos concretos. Si estableces etiquetas de asignación utilizando el operador de Kubernetes, los valores que estableces en el archivo de configuración de Kubernetes para las etiquetas de asignación sobrescriben los valores definidos en la interfaz de usuario de MongoDB Ops Manager. Las etiquetas de asignación que no estableces utilizando el operador de Kubernetes continúan utilizando los valores establecidos en la interfaz de usuario de MongoDB Ops Manager.

spec.backup.s3Stores.customCertificate

Tipo: booleano

Deprecated. Use spec.backup.s3Stores.customCertificateSecretRefs instead.

Flag que indica si utiliza los certificados de la base de datos de la aplicación (appdb-ca) como certificado TLS personalizado para sus copias de seguridad de S3. El valor por defecto es False.

spec.backup.s3Stores.customCertificateSecretRefs

Tipo: arreglo de objetos

Lista de certificados personalizados para su almacenamiento de snapshot S3 mediante secretos de Kubernetes. El64certificado x. codificado509 en base ya debe estar presente en un secreto de Kubernetes con una clave y debe poder ser analizado por el Java CertifcateFactory. No puede especificar varios certificados en una cadena en un secreto. Si especifica varios certificados en una cadena en un secreto, el operador de Kubernetes utiliza solo el primer certificado de la cadena. Si también proporciona la configuración spec.backup.s3Stores.customCertificate, el operador de Kubernetes utiliza el spec.applicationDatabase.security.tls.ca como certificado personalizado para las copias de seguridad.

Each entry in the list specifies the name and the key. If you specify multiple secrets, Kubernetes Operator uses all the specified secrets.

Si no proporciona esta configuración, el Kubernetes operador utiliza el JVM Trust Store por defecto usado por Ops Manager para copias de seguridad.

spec.backup.s3Stores.customCertificateSecretRefs.name

Tipo: string

Requerido para utilizar certificados personalizados para tu S3 tienda de Oplog. Secreto de Kubernetes secret que contiene el certificado personalizado.

spec.backup.s3Stores.customCertificateSecretRefs.key

Tipo: string

Requerido para utilizar certificados personalizados para su S3 oplog store. Archivo que representa la clave en el secreto que contiene el certificado x.509 codificado en base64. Si no especifica esta configuración, el Operador de Kubernetes no puede utilizar el certificado personalizado para el almacenamiento de snapshot de S3 y por defecto utilizará el almacén de confianza predeterminado utilizado por MongoDB Ops Manager.

spec.backup.s3Stores.irsaEnabled

Tipo: booleano

Indicador que permite usar AWS roles de IAM para cuentas de servicio en AWS EKS para configurar un almacenamiento de snapshot S3. El valor por defecto es False. Si no utiliza AWS EKS, esta marca no tiene ningún efecto. Cuando se establece en False, el uso de AWS roles de IAM para cuentas de servicio en EKS para configurar un almacenamiento de snapshot S3 está deshabilitado. Para obtener más información, consulte IAM roles for service accounts in EKS.

spec.backup.s3Stores.name

Tipo: string

Es necesario almacenar el oplog utilizando un almacenamiento S3. Nombre del almacenamiento de snapshot S3.

Importante

Una vez especificado, no edites el nombre del almacenamiento de snapshot de S3. Es probable que este cambio falle si las copias de seguridad utilizan el nombre anterior. Las consecuencias de un cambio exitoso son impredecibles.

spec.backup.s3Stores.mongodbResourceRef.name

Tipo: string

Nombre del recurso MongoDB o del recurso MongoDBMultiCluster que cree para almacenar metadatos para el almacenamiento de snapshot de S3. Debe implementar este recurso de base de datos en el mismo namespace que el recurso de Ops Manager.

Nota

Omita esta configuración para utilizar la base de datos de la aplicación para almacenar metadatos para el almacenamiento de snapshot S3.

If you omit this setting, you must also omit the spec.backup.s3Stores.mongodbUserRef.name setting. The Kubernetes Operator handles SCRAM user authentication internally.

Si habilitas la autenticación SCRAM en esta base de datos, debes:

• Crea un recurso de usuario de MongoDB para conectar Ops Manager a la base de datos.

• Specify the name of the user in the Ops Manager resource definition.

Importante

Una vez especificado, no edites el nombre del almacenamiento de snapshot de S3. Es probable que este cambio falle si las copias de seguridad utilizan el nombre anterior. Las consecuencias de un cambio exitoso son impredecibles.

Si un recurso de base de datos MongoDB con este nombre no existe, el recurso backup entra en el estado Pending. El operador de Kubernetes reintenta cada 10 segundos hasta que se cree un recurso de base de datos MongoDB con este nombre.

Nota

El operador de Kubernetes comienza a conciliar el recurso Ops Manager automáticamente cuando se realizan cambios de seguridad en los recursos de base de datos referenciados en esta configuración. El operador de Kubernetes actualiza los indicadores mongoUri y ssl en la configuración del Ops Manager según tus cambios.

spec.backup.s3Stores.mongodbUserRef.name

Tipo: string

Obligatorio si creaste un recurso de base de datos MongoDB para almacenar metadatos de snapshot |s3| y SCRAM está habilitado en esta base de datos. Nombre del recurso de usuario de MongoDB utilizado para conectarse a la base de datos de metadatos del almacenamiento de snapshot S3. Implementa este recurso de usuario en el mismo namespace que el recurso de MongoDB Ops Manager y con todos los siguientes roles:

• readWriteAnyDatabase

• dbAdminAnyDatabase

• clusterMonitor

Importante

Una vez especificado, no edite el nombre del nombre de usuario del almacenamiento de snapshot de metadatos S3.

spec.backup.s3Stores.s3SecretRef.name

Tipo: string

Requerido si habilitas la copia de seguridad utilizando un almacén S3 y no estableces spec.backup.s3Stores.irsaEnabled en true.

Nombre del secreto que contiene los campos accessKey y secretKey. El servicio de daemon de copias de seguridad utiliza los valores de estos campos como credenciales para acceder a tu bucket compatible con AWS S3 o S3. El almacenamiento de snapshot de S3 no se puede configurar si al secreto le falta alguna de las llaves.

Si configuras spec.backup.s3Stores.irsaEnabled como true, no necesitas configurar s3SecretRef, porque las credenciales de AWS S3 se montan como variables de entorno del pod.

spec.backup.s3Stores.pathStyleAccessEnabled

Tipo: booleano

Indica el estilo de la URL del endpoint del bucket.

Valor	Descripción	Ejemplo
true	URL con estilo de ruta	s3.amazonaws.com/<bucket>
false	URL con estilo de host virtual	<bucket>.s3.amazonaws.com

El valor por defecto es true.

spec.backup.s3Stores.s3BucketEndpoint

Tipo: string

Requerido si habilita la copia de seguridad utilizando un S3 almacenar. URL del bucket AWS S3 o del bucket compatible con S3que aloja el almacenamiento de snapshot.

Nota

Si su endpoint no incluye una región en su URL, especifique el campo s3RegionOverride.

spec.backup.s3Stores.s3BucketName

Tipo: string

Requerido si habilita la copia de seguridad utilizando un S3 almacenar. Nombre del bucket de Amazon Web Services S3 o del bucket compatible con S3que aloja el almacenamiento de snapshot.

spec.backup.s3Stores.s3RegionOverride

Tipo: string

Región donde reside su bucket compatible con S3. Utilice este campo solo si el almacén S3 no admite el alcance de la región.s3BucketEndpoint El alcance de la región se produce cuando el punto de conexión no incluye una región en su URL.

No utilice este campo con los cubos de Amazon Web Services S.3 Para obtener más información, consulte la Configuración de almacenamiento en bloques S3.

Configuraciones de Prometheus

La configuración siguiente se aplica cuando utilizas Prometheus con tu base de datos de la aplicación:

spec.applicationDatabase.prometheus

Tipo: arreglo

opcional. Lista que contiene los parámetros para exponer métricas a Prometheus.

spec.applicationDatabase.prometheus.metricsPath

Tipo: string

Por defecto: "/metrics"

Opcional. String legible para el usuario que indica la ruta al endpoint de métricas. Si no especificas esta configuración, se aplica la por defecto.

spec.applicationDatabase.prometheus.passwordSecretRef

Tipo: Objeto

Condicional Objeto que contiene los detalles del secreto para la autenticación HTTP básica. Si deseas usar Prometheus con tu Base de Datos de la Aplicación, debes especificar esta configuración.

spec.applicationDatabase.prometheus.passwordSecretRef.key

Tipo: string

Por defecto: "password"

opcional. string legible por humanos que identifica la clave en el secreto que almacena la contraseña para la autenticación HTTP básica. Si no especificas este ajuste, se aplica el ajuste por defecto.

spec.applicationDatabase.prometheus.passwordSecretRef.name

Tipo: string

Condicional

Etiqueta legible por humanos que identifica el secreto que contiene la contraseña para la autenticación HTTP básica. Si quieres usar Prometheus con tu base de datos de la aplicación, debes especificar esta configuración.

spec.applicationDatabase.prometheus.port

Tipo: entero

por defecto: 9216

opcional. Número que identifica el puerto al que se vinculará el endpoint de métricas. Si no especificas esta configuración, se aplicará la por defecto.

spec.applicationDatabase.prometheus.tlseSecretKeyRef

Tipo: Objeto

Opcional. Objeto que contiene los detalles del secreto para autenticación TLS.

spec.applicationDatabase.prometheus.tlseSecretKeyRef.key

Tipo: string

Por defecto: "password"

opcional. string legible por el usuario que identifica la clave en el secreto que almacena la contraseña para la autenticación TLS. Si no se especifica esta configuración, se aplicará la por defecto.

spec.applicationDatabase.prometheus.tlseSecretKeyRef.name

Tipo: string

Condicional. Etiqueta legible por humanos que identifica el secreto que contiene la contraseña para la autenticación TLS. Si quieres usar Prometheus con tu base de datos de la aplicación y usar la autenticación TLS, debes especificar esta configuración.

spec.applicationDatabase.prometheus.username

Tipo: string

Condicional. Etiqueta legible por humanos que identifica al usuario para la autenticación HTTP básica. Si quieres utilizar Prometheus con tu base de datos de la aplicación, debes especificar esta configuración.

Configuraciones requeridas de Ops Manager

Esta sección describe los ajustes que debes utilizar para tu implementación multiclúster de Ops Manager además de los ajustes obligatorios de Ops Manager.

spec.clusterSpecList.members

Tipo: entero

Conditional. The number of Ops Manager members in the Ops Manager cluster in a multi-Kubernetes cluster MongoDB deployment. When you set spec.topology to MultiCluster, you must specify the value for this parameter. Omit this parameter for single-cluster deployments. If you set this parameter to zero, this removes this Ops Manager member cluster from the list of member clusters in the multi-Kubernetes cluster of Ops Manager instances.

spec.topology

Tipo: string

El tipo de implementación de Kubernetes para el recurso de Ops Manager.

• Los valores son SingleCluster o MultiCluster. Si se omite, el valor por defecto es SingleCluster.

• Si especificas MultiCluster:

  • Añadir el recurso MongoDBMultiCluster a la lista de recursos supervisados. Esto indica al operador de Kubernetes que debe trabajar en modo multiclúster de Kubernetes y realizar las acciones de configuración necesarias para gestionar recursos multi-Kubernetes.

  • Specify at least one member cluster on which you want to deploy Ops Manager, using spec.clusterSpecList and its nested spec.clusterSpecList.clusterName and spec.clusterSpecList.members parameters.

  • Si especifica MultiCluster, el Operador de Kubernetes ignora cualquier valor que configure para spec.members. Consulta el ejemplo de la especificación de recursos.

Configuraciones opcionales de Ops Manager

Los recursos de Ops Manager también pueden utilizar los siguientes ajustes específicos para implementaciones de Ops Manager en varios clústeres:

spec.clusterSpecList

tipo: colección

Condicional. Detalles de los clústeres miembro de Kubernetes seleccionados en un clúster multi-Kubernetes donde se pretende implementar instancias de Ops Manager o daemon de copias de seguridad. Consulte también el ejemplo de la especificación del recurso.

• When you set spec.topology to MultiCluster, you must specify the value for spec.clusterSpecList.members. All other parameters under spec.clusterSpecList are optional.

• When you set spec.topology to SingleCluster, the Kubernetes Operator ignores all parameters under spec.clusterSpecList.

spec.clusterSpecList.clusterName

Tipo: string

opcional. Nombre del clúster de Kubernetes nodo en una implementación de MongoDB con múltiples clústeres de Kubernetes, donde el Operador de MongoDB Controllers for Kubernetes programa el StatefulSet para Ops Manager o el daemon de copias de seguridad.

spec.clusterSpecList.clusterDomain

Tipo: string

opcional. Una anulación para spec.clusterDomain para el clúster de nodo específico de MongoDB Ops Manager. Si omite este valor, se establecerá por defecto el valor configurado en spec.clusterDomain. Kubernetes asigna a cada Pod un FQDN. El operador de Kubernetes calcula el FQDN para cada Pod utilizando un valor clusterDomain proporcionado. Kubernetes no proporciona una API para query estos nombres de host.

spec.clusterSpecList.configuration

tipo: colección

Optional. Ops Manager configuration properties that override properties you set in spec.configuration for the specific cluster. See Ops Manager Configuration Settings for property names and descriptions. Each property takes a value of type string. For example, setting these properties allows you to change environment variables that you must pass to Ops Manager and the Backup Daemon in that particular member cluster.

If you omit specifying values, defaults to the values set in spec.configuration.

spec.clusterSpecList.jvmParameters

Tipo: arreglo de cadenas

opcional. Se pasan al JVM los parámetros de Ops Manager y a las instancias del daemon de copias de seguridad para este clúster nodo.

• If you specify this parameter, its values override the values specified in spec.jvmParameters. For example values, see the example of the resource specification.

• If you omit this parameter, values from the spec.jvmParameters are used for the Ops Manager and Backup Daemon instances in this member cluster.

spec.clusterSpecList.externalConnectivity

tipo: colección

Optional. Configuration object that enables external connectivity to Ops Manager for the specific cluster. This is an override for spec.externalConnectivity for the specific cluster.

Especifica los valores para este parámetro con el fin de cambiar cómo se expone externamente la aplicación de Ops Manager en diferentes clústeres. Por ejemplo, si despliega Ops Manager en nodos de Kubernetes en diferentes proveedores de la nube, es posible que deba especificar valores específicos del proveedor para este parámetro.

Si estableces este parámetro:

• The Kubernetes Operator doesn't use spec.externalConnectivity values for this member Ops Manager cluster.

• The Kubernetes Operator creates a Kubernetes service, named <om-name>-svc-ext, that allows traffic originating from outside of the Kubernetes cluster to reach the Ops Manager application on this member cluster.

If you omit this parameter, the Kubernetes Operator uses values from spec.externalConnectivity for this member cluster.

spec.clusterSpecList.statefulSet.spec

tipo: colección

Optional. Specification for the StatefulSet that the MongoDB Controllers for Kubernetes Operator creates for a specific member cluster in the multi-Kubernetes cluster Ops Manager deployment. This parameter is an override for spec.statefulSet.spec. If you omit it, the Kubernetes Operator uses the values from spec.statefulSet.spec. For example, you can use this parameter to specify different storage values for each of your Ops Manager clusters in the multi-Kubernetes cluster MongoDB deployment.

To review which fields you can add to spec.clusterSpecList.statefulSet.spec, see StatefulSetSpec v1 apps in the Kubernetes documentation.

spec.clusterSpecList[*].backup

opcional. Configuración de copias de seguridad que anula los valores especificados en spec.backup para ese clúster miembro en particular.

• You can set these values only if spec.backup.enabled is set to true.

• Si omites establecer cualquier valor para este parámetro, se usarán los valores por defecto especificados en la configuración bajo spec.backup.

• No todos los ajustes de copia de seguridad están disponibles en esta opción de anulación. No puedes anular los siguientes ajustes de copia de seguridad porque se aplican globalmente a todos los clústeres de nodos, si se especifican bajo spec.backup:

  • externalServiceEnabled

  • headDB

  • opLogStores

  • blockStores

  • s3Stores

  • fileSystemStores

  • queryableBackupSecretRef

  • encryption

spec.clusterSpecList[*].backup.members

Tipo: entero

Optional. Override for spec.backup.members. The number of Backup Daemon instances to deploy in this cluster. if you omit this value or provide a value of 0, the Kubernetes Operator won't deploy Backup Daemon instances in a particular member cluster.

spec.clusterSpecList[*].backup.assignmentLabels

Tipo: arreglo de cadenas

Optional. Override for spec.backup.assignmentLabels. If specified, the Kubernetes Operator uses the values you specify in this override for all Backup Daemon instances in a particular member cluster. If you omit values for this parameter, the values default to those specified in spec.backup.assignmentLabels for all Backup Daemon instances in a member cluster.

spec.clusterSpecList[*].backup.jvmParameters

Tipo: arreglo de cadenas

opcional. Anulación para spec.backup.jvmParameters. Le permite personalizar el valor de JVM para las instancias de daemon de copias de seguridad en un clúster de nodos específico.

spec.clusterSpecList[*].backup.statefulSet

Tipo: string

Opcional. Anulación paraspec.backup.statefulSet.spec. Permite personalizar los valores de un demonio de copia de seguridad en un clúster miembro específico. Para consultar los campos que puede agregar aspec.clusterSpecList[*].backup.statefulSet, vea StatefulSetSpec v1 apps en la documentación de Kubernetes.

Configuración requerida de la base de datos de la aplicación

Esta sección describe los ajustes específicos de tu implementación de Ops Manager de múltiples clústeres que debes usar para tu base de datos de la aplicación.

spec.applicationDatabase.clusterSpecList

tipo: colección

Detalles de los clústeres nodo seleccionados de Kubernetes en una implementación de clúster MongoDB multi-Kubernetes que funcionan como nodos que albergan la base de datos de la aplicación.

spec.applicationDatabase.clusterSpecList.clusterName

Tipo: string

Nombre del clúster nodo de Kubernetes en una implementación multi-Kubernetes de MongoDB donde los Controladores de MongoDB para el operador de Kubernetes programa el StatefulSet para la base de datos de la aplicación.

Importante

You can't convert a single cluster Ops Manager instance to a multi-Kubernetes cluster MongoDB deployment instance by modifying the topology and the clusterSpecList settings in the CRD.

spec.applicationDatabase.clusterSpecList.members

Tipo: número

Número de nodos statefulSet en el clúster de miembros dado. El nodo clúster es uno de los nodos clústeres que alojan la base de datos de la aplicación en una implementación de MongoDB con múltiples clústeres de Kubernetes.

spec.applicationDatabase.topology

Tipo: string

El tipo de implementación de Kubernetes para la base de datos de la aplicación.

• Los valores son SingleCluster o MultiCluster. Si se omite, el valor por defecto es SingleCluster.

• Si especifica MultiCluster, debe especificar al menos un nodo

• cluster on which you want to deploy the Application Database using the clusterSpecList, clusterName, members parameters.

• Si especificas MultiCluster, el operador de Kubernetes ignora los valores que establezca para el campo spec.applicationDatabase.members.

Para obtener más información, consulta el ejemplo de la especificación del recurso multidistribuido.

Configuraciones opcionales de la base de datos de la aplicación

Esta sección describe la configuración específica de tu implementación de Ops Manager de múltiples clústeres que puedes usar para tu base de datos de la aplicación.

spec.applicationDatabase.clusterSpecList.externalAccess

Tipo: string

Un dominio externo utilizado para exponer externamente su implementación de set de réplicas.

Por defecto, cada nodo del set de réplicas utiliza el FQDN (*.svc.cluster.local) del Pod de Kubernetes como nombre de host por defecto. Sin embargo, si agrega un dominio externo a esta configuración, el set de réplicas utiliza un nombre de host que es un subdominio del dominio especificado en su lugar. Este nombre de host utiliza el siguiente formato:

<replica-set-name>-<cluster-idx>-<pod-idx>.<externalDomain>

Por ejemplo:

multi-replica-set-0-1.cluster-0.example.com

Importante

Utiliza este ajuste solo cuando despliegues una implementación de base de datos de la aplicación sin una malla de servicios. Consulta Ops Manager multiplataforma sin una malla de servicios.

spec.applicationDatabase.clusterSpecList.memberConfig

Tipo: arreglo de cadenas

Especificación para cada miembro del set de réplicas de la base de datos de la aplicación en su implementación multiclúster de Ops Manager.

Importante

If you set spec.topology to SingleCluster, use spec.applicationDatabase.memberConfig instead of spec.applicationDatabase.clusterSpecList.memberConfig.

The number of elements in the memberConfig list must equal spec.applicationDatabase.clusterSpecList.members.

El orden de los elementos en la lista memberConfig debe estar alineado con el orden de los nodos en el set de réplicas. Por ejemplo, el primer elemento del arreglo afecta al pod en el índice 0, el segundo elemento afecta al índice 1 y así sucesivamente.

Ejemplo

Considera la siguiente especificación de ejemplo para un set de réplicas de tres nodos para la base de datos de la aplicación:

spec:
  replicas: 3
  version: 8.0.0
  backup:
    enabled: true
  storage:
    resources:
      requests:
        storage: 10Gi
      storageClassName: standard
  applicationDatabase:
    clusterSpecList:
      - name: appdb
        members: 3
        memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
              tag1: "value1"
              environment: "prod"
          - votes: 1
            priority: "1.5"
            tags:
              tag2: "value2"
              environment: "prod"
          - votes: 0
            priority: "0"
            tags:
              tag2: "value2"
              environment: "prod"

spec.applicationDatabase.clusterSpecList.memberConfig.priority

Tipo: string

Número que indica la probabilidad relativa de que un miembro del conjunto de réplicas de la base de datos de la aplicación se convierta en primario.

• Para aumentar la probabilidad relativa de que un miembro del set de réplicas se convierta en el primario, es necesario especificar un valor de priority más alto.

• Para disminuir la probabilidad relativa de que un miembro del set de réplicas se convierta en el primario, especifica un valor priority más bajo.

Por ejemplo, un nodo con un memberConfig.priority de 1.5 es más probable que se convierta en primario que un nodo con un memberConfig.priority de 0.5.

Un nodo con un memberConfig.priority de 0 no es elegible para convertirse en el titular primario. Para obtener más información, consulta Prioridad de nodos.

spec.applicationDatabase.clusterSpecList.memberConfig.tags

Tipo: mapa

Mapa de etiquetas de set de réplicas para dirigir las operaciones de lectura y escritura a miembros específicos del set de réplicas de tu base de datos de la aplicación.

spec.applicationDatabase.clusterSpecList.memberConfig.votes

Tipo: número

Determines whether an Application Database replica set member can vote in an election. Set to 1 to allow the member to vote. Set to 0 to exclude the member from an election.