Docs Menu
Docs Home
/ /
/ / /

Especificación de recursos de Ops Manager

El El operador de MongoDB Controllers for Kubernetes crea una implementación de Ops Manager en contenedores a partir de archivos de especificaciones que usted escribe.

Después de crear o actualizar una especificación de recurso de Ops Manager, debe indicar a MongoDB Controllers for Kubernetes Operator que la aplique a su entorno de Kubernetes. Kubernetes Operator crea los servicios y recursos de Kubernetes personalizados que Ops Manager requiere y, a continuación, implementa Ops Manager y su base de datos de aplicaciones de respaldo en contenedores de su entorno de Kubernetes.

Cada recurso de Ops Manager utiliza una especificación de objeto en YAML para definir las características y configuraciones de la implementación.

Los siguientes ejemplos muestran una especificación de recursos para una implementación de Ops Manager:

1apiVersion: mongodb.com/v1
2kind: MongoDBOpsManager
3metadata:
4 name: om
5spec:
6 topology: SingleCluster # optional, SingleCluster by default
7 opsManagerURL: https://link.to.configured.load-balancer.example.com # optional OM URL for the operator
8replicas: 1
9version: "8.0.0"
10 adminCredentials: ops-manager-admin-secret
11 configuration:
12 mms.fromEmailAddr: admin@example.com
13 mms.security.allowCORS: "false"
14 security:
15 tls:
16 ca: issuer-ca
17 backup:
18 enabled: true
19 encryption:
20 kmip:
21 server:
22 url: kmip.corp.mongodb.com:5696
23 ca: mongodb-kmip-certificate-authority-pem
24 headDB:
25 storage: "30Gi"
26 labelSelector:
27 matchLabels:
28 app: my-app
29 opLogStores:
30 - name: oplog1
31 # Sets labels for the oplog store.
32 assignmentLabels: ["test1", "test2"]
33 mongodbResourceRef:
34 name: my-oplog-db
35 mongodbUserRef:
36 name: my-oplog-user
37 s3Stores:
38 - name: s3store1
39 # Sets labels for the S3 store.
40 assignmentLabels: ["test1", "test2"]
41
42 mongodbResourceRef:
43 name: my-s3-metadata-db
44 mongodbUserRef:
45 name: my-s3-store-user
46 s3SecretRef:
47 name: my-s3-credentials
48 pathStyleAccessEnabled: true
49 s3BucketEndpoint: s3.region.amazonaws.com
50 s3BucketName: my-bucket
51 applicationDatabase:
52 passwordSecretKeyRef:
53 name: om-db-user-secret
54 key: password
55 members: 3
56 topology: SingleCluster
57 version: "7.0.21-ubi8"
58 featureCompatibilityVersion: "6.0" # During upgrade, set this FCV value to your currently deployed AppDB version.
59 security:
60 certsSecretPrefix: appdb
61 tls:
62 ca: issuer-ca
1apiVersion: mongodb.com/v1
2kind: MongoDBOpsManager
3metadata:
4 name: om
5spec:
6 topology: MultiCluster # optional, SingleCluster by default
7 opsManagerURL: https://link.to.configured.lb.example.com # optional OM URL for the operator
8 clusterSpecList: # optional ClusterSpecOMItem list, the type is different than ClusterSpecItem for AppDB and MongoDB
9 - clusterName: cluster-1 # required
10 replicas: 1 # required, OM application replicas
11 # optional parameters to override those defined at MongoDBOpsManager level
12 clusterDomain: cluster-1.example.com # optional, default cluster.local
13 jvmParameters: ["-Xmx4352m","-Xms4352m"]
14 externalConnectivity: # optional to override
15 type: LoadBalancer
16 port: 9090
17 annotations:
18 key: value
19 statefulSet: # StatefulSetSpecWrapper override
20 spec: {}
21 metadata: {}
22 configuration:
23 automation.versions.source: mongodb
24 mms.adminEmailAddr: cloud-manager-support@mongodb.com
25 backup: # MongoDBOpsManagerBackup, optional, we only support a subset of fields
26 members: 1 # backup daemon replicas, optional, default=1
27 assignmentLabels: [] # assignment labels to override
28 jvmParameters: ["-Xmx4352m","-Xms4352m"] # optional
29 statefulSet: # mdbc.StatefulSetConfiguration, optional to override for backup daemon
30 spec: {}
31 metadata: {}
32 - clusterName: cluster-2
33 replicas: 1
34
35 ....
36
37replicas: 1
38 version: "8.0.0"
39 adminCredentials: ops-manager-admin-secret
40 configuration:
41 mms.fromEmailAddr: admin@example.com
42 mms.security.allowCORS: "false"
43 backup:
44 enabled: true
45 encryption:
46 kmip:
47 server:
48 url: kmip.corp.mongodb.com:5696
49 ca: mongodb-kmip-certificate-authority-pem
50 headDB:
51 storage: "30Gi"
52 labelSelector:
53 matchLabels:
54 app: my-app
55 opLogStores:
56 - name: oplog1
57 # Sets labels for the oplog store.
58 assignmentLabels: ["test1", "test2"]
59 mongodbResourceRef:
60 name: my-oplog-db
61 mongodbUserRef:
62 name: my-oplog-user
63 s3Stores:
64 - name: s3store1
65 # Sets labels for the S3 store.
66 assignmentLabels: ["test1", "test2"]
67
68 mongodbResourceRef:
69 name: my-s3-metadata-db
70 mongodbUserRef:
71 name: my-s3-store-user
72 s3SecretRef:
73 name: my-s3-credentials
74 pathStyleAccessEnabled: true
75 s3BucketEndpoint: s3.region.amazonaws.com
76 s3BucketName: my-bucket
77 security:
78 tls:
79 ca: issuer-ca
80 applicationDatabase:
81 passwordSecretKeyRef:
82 name: om-db-user-secret
83 key: password
84 version: "8.0.0-ubi8"
85 topology: MultiCluster
86 clusterSpecList:
87 - clusterName: cluster1.example.com
88 members: 4
89 - clusterName: cluster2.example.com
90 members: 3
91 - clusterName: cluster3.example.com
92 members: 2
93 security:
94 certsSecretPrefix: appdb
95 tls:
96 ca: issuer-ca

Esta sección describe las configuraciones que debe utilizar para todos los recursos de Ops Manager.

apiVersion

Tipo: string

Obligatorio. Versión del esquema de recursos de Kubernetes de MongoDB.

kind

Tipo: string

Obligatorio. Tipo de recurso de MongoDB Kubernetes que se creará. Establézcalo MongoDBOpsManager en.

metadata.name

Tipo: string

Obligatorio. Nombre del recurso MongoDB Kubernetes que está creando.

Los nombres de recursos deben tener 44 caracteres o menos.

spec.version

Tipo: string

Obligatorio. Versión de Ops Manager que desea instalar en este recurso de MongoDB Kubernetes.

spec.adminCredentials

Tipo: string

Obligatorio. Nombre del secreto de Kubernetes que creó para el usuario administrador de Ops Manager. Al implementar el recurso de Ops Manager, el operador de Kubernetes crea un usuario con estas credenciales.

Nota

Para evitar almacenar secretos en implementaciones de Kubernetes de un solo clúster, puede migrar todos los secretos a un Herramienta de almacenamiento de secretos. Las implementaciones en varios clústeres de Kubernetes no admiten el almacenamiento de secretos en herramientas de almacenamiento de secretos, como HashiCorp Vault.

Al usuario administrador se le otorga el rol Propietario global.

spec.replicas

Tipo: entero

Condicional. Número de instancias de Ops Manager que se ejecutan en paralelo. Si especifica SingleCluster spec.topologyen, este parámetro es obligatorio. El valor mínimo aceptado 1 es.

Si especifica MultiCluster en, este parámetro se spec.topology ignora.

Los recursos de Ops Manager también pueden usar las siguientes configuraciones:

spec.backup.fileSystemStores

Tipo: string

Nombre que identifica el almacén de instantáneas del sistema de archivos. Para obtener más información, consulte Configurar el almacén de copias de seguridad del sistema de archivos con el operador de Kubernetes.

spec.backup.logging.LogBackAccessRef

Tipo: string

Referencia a un ConfigMap que contiene un archivo logback-access.xml personalizado para configurar los registros de respaldo de Ops Manager.

La clave en ConfigMap debe coincidir exactamente con el nombre de logback-access.xml para garantizar que reemplace el archivo predeterminado en los pods de Ops Manager.

Para obtener más información, consulte Configurar registros de Ops Manager con CRD.

spec.backup.logging.LogBackRef

Tipo: string

Referencia a un ConfigMap que contiene un archivo logback.xml personalizado. Este archivo configura el comportamiento general de registro para las copias de seguridad de Ops Manager, incluyendo políticas de rotación de registros, niveles de registro y otros parámetros de registro.

La clave en ConfigMap debe coincidir exactamente con el nombre de logback-access.xml para garantizar que reemplace el archivo predeterminado en los pods de Ops Manager. Para obtener más información, consulte Configurar los registros de Ops Manager con el CRD.

spec.logging.LogBackAccessRef

Tipo: string

Referencia a un ConfigMap que contiene un archivo logback-access.xml personalizado para configurar los registros de Ops Manager.

La clave en ConfigMap debe ser exactamente logback-access.xml para garantizar que reemplace el archivo predeterminado en los pods de Ops Manager.

Para obtener más información, consulte Configurar registros de Ops Manager con CRD.

spec.logging.LogBackRef

Tipo: string

Referencia a un ConfigMap que contiene un archivo logback.xml personalizado. Este archivo configura el comportamiento general de registro de Ops Manager, incluyendo políticas de rotación de registros, niveles de registro y otros parámetros de registro.

La clave en ConfigMap debe ser exactamente logback.xml para garantizar que reemplace el archivo predeterminado en los pods de Ops Manager.

Para obtener más información, consulte Configurar registros de Ops Manager con CRD.

spec.opsManagerURL

Tipo: string

Opcional. La URL del recurso Ops Manager en el operador de Kubernetes, porhttps://link.to.configured.lb.example.com ejemplo:.

  • Si omite este parámetro, para conectarse a las instancias de Ops Manager, el operador de Kubernetes utiliza la siguiente URL como predeterminada para la instancia de Ops Manager:. <om-name>-svc.{namespace}.svc.cluster.local Este es el FQDN del servicio sin interfaz gráfica para Ops Manager.

  • Si especifica este parámetro, podrá cambiar esta URL a una diferente.

Nota

No confunda el con spec.opsManagerURL la URL que especifica en un ConfigMap para una implementación específica a fin de configurar las implementaciones de MongoDB y los agentes de monitorización para la base de datos de la aplicación. El operador de Kubernetes necesita el spec.opsManagerURL para conectarse directamente a las instancias de Ops Manager y configurar las implementaciones de Ops Manager y la base de datos de la aplicación. El operador de Kubernetes no utiliza el spec.opsManagerURL para administrar bases de datos MongoDB específicas.

Cambie el parámetro a una URL personalizada en los siguientes spec.opsManagerURL casos:

  • Al implementar Ops Manager en varios clústeres de Kubernetes y no se puede acceder a la URL predeterminada desde el pod que aloja Ops Manager. Por ejemplo, al implementar Ops Manager en clústeres de Kubernetes distintos de aquellos en los que se implementa el operador de Kubernetes, es posible que no se pueda acceder al FQDN del servicio Ops Manager. En este caso, puede especificar una URL personalizada.

  • Al configurar el acceso externo a la instancia de Ops Manager en un dominio externo, puede especificar una URL personalizada. Esto también requiere que el operador de Kubernetes y los agentes de monitorización de la base de datos de la aplicación usen esta URL personalizada en lugar de la predeterminada.

spec.clusterDomain

Tipo: string

Kubernetes asigna a cada Pod un FQDN. El Operador de Kubernetes calcula el FQDN para cada Pod usando un clusterDomain proporcionado. Kubernetes no proporciona una API para query estos nombres de host.

spec.clusterName

Importante

spec.clusterName está obsoleto

Se debe utilizar spec.clusterDomain en su lugar.

Tipo: string

Kubernetes asigna a cada Pod un FQDN. El Operador de Kubernetes calcula el FQDN para cada Pod usando un clusterName proporcionado. Kubernetes no proporciona una API para query estos nombres de host.

spec.configuration

Tipo: colección

Propiedades de configuración de Ops Manager. Consulte la sección "Ops Manager Configuration Settings" para ver los nombres y descripciones de las propiedades. Cada propiedad toma un valor de string tipo.

Importante

Si Ops Manager va a gestionar recursos de MongoDB implementados fuera del clúster de Kubernetes en el que está implementado, debes agregar la configuración mms.centralUrl a spec.configuration.

Establezca el valor en la URL mediante la cual Ops Manager se expone fuera del clúster de Kubernetes.

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

spec.configuration.mms.featureFlag.automation.verifyDownloads

Tipo: string

Cuando se configura en enabled, el Agente MongoDB requiere archivos de firma para todas las implementaciones de MongoDB que administra su instancia de Ops Manager.

Cuando actualiza el Agente MongoDB con esta opción habilitada, la versión actual del Agente MongoDB requiere archivos de firma del nuevo binario del Agente MongoDB.

Para obtener más información, consulte Verificar firmas de MongoDB.

spec.configuration.mms.featureFlag.backup.queryable

Tipo: booleano

Establezca en false para deshabilitar las copias de seguridad consultables.

spec.configuration.mms.featureFlag.backup.wt.queryable

Tipo: booleano

Establezca en false para deshabilitar las copias de seguridad consultables al usar WiredTiger.

spec.configuration.mms.mongoDbUsage.defaultUsageType

Tipo: string

El tipo de servidor predeterminado del servicio Kubernetes.

Los valores aceptados son: PRODUCTION_SERVER, TEST_SERVER, DEV_SERVER y RAM_POOL.

spec.jvmParameters

Tipo: arreglo de cadenas

Opcional. Los parámetros dela JVM se pasan a la aplicación Ops Manager en el contenedor. Los parámetros especificados reemplazan los parámetros predeterminados de la JVM para la aplicación Ops Manager.

Este parámetro del operador de Kubernetes tiene como valor predeterminado una lista vacía.

spec:
jvmParameters: ["-XX:+HeapDumpOnOutOfMemoryError","-XX:HeapDumpPath=/tmp"]

Importante

Cambie los valores del montón de memoria JVM bajo su propio riesgo

El operador de Kubernetes calcula los valores del montón de memoria de la JVM de la aplicación Ops Manager basándose en la memoria del contenedor. Cambiar los -Xms -Xmx valores y puede causar problemas con Ops Manager.

spec.security.certsSecretPrefix

Tipo: string

Texto para agregar como prefijo al secreto de Kubernetes que creó y que contiene la clave TLS y el certificado de Ops Manager.

Debes nombrar tu secreto <prefix>-<metadata.name>-cert.

Para aprender a configurar su instancia de Ops Manager para que se ejecute mediante HTTPS, consulte Implementar un recurso de Ops Manager.

spec.security.tls.ca

Nombre del ConfigMap de Kubernetes que contiene un archivo CA personalizado para Ops Manager.

Importante

spec.security.tls.ca es requerido si utilizas un CA personalizado para firmar tus certificados TLS de Ops Manager.

El operador de Kubernetes requiere que usted nombre el certificado para el recurso Ops Manager mms-ca.crt en ConfigMap.

Esta CA firma los certificados que:

  • Los clientes utilizan para conectarse a la aplicación Ops Manager y

  • Los agentes en los pods de la base de datos de aplicaciones se utilizan para comunicarse con Ops Manager.

Advertencia

Debe concatenar su archivo CA personalizado y toda la cadena de certificados TLS de downloads.mongodb.com para evitar que Ops Manager deje de funcionar si se reinicia la base de datos de la aplicación.

spec.security.tls.enabled

Importante

spec.security.tls.enabled Está obsoleto y se eliminará en una próxima versión. Para habilitar TLS, proporcione un valor para la spec.security.certsSecretPrefix configuración.

Cifra las comunicaciones mediante certificados TLS entre los clientes y Ops Manager.

spec.statefulSet.spec

Tipo: colección

Especificación para el StatefulSet que el operador de controladores MongoDB para Kubernetes crea para Ops Manager.

Para revisar qué campos puedes agregar spec.statefulSet.spec a, consulta las aplicaciones StatefulSetSpec v1 en la documentación de Kubernetes.

spec.statefulSet.spec.template

Tipo: colección

Plantilla para los pods de Kubernetes en el StatefulSet que el operador de controladores MongoDB para Kubernetes crea para Ops Manager.

Nota

El operador de Kubernetes no valida los campos que proporciona spec.statefulSet.spec.template en.

spec.statefulSet.spec.template.metadata

Tipo: colección

Metadatos para los pods de Kubernetes en el StatefulSet que el operador de controladores MongoDB para Kubernetes crea para Ops Manager.

Para revisar qué campos puedes agregar a, consulta spec.statefulSet.spec.template.metadata la documentación de Kubernetes.

spec.statefulSet.spec.template.spec

Tipo: colección

Especificaciones de los pods de Kubernetes en el StatefulSet que el operador de controladores MongoDB para Kubernetes crea para Ops Manager.

Para revisar la lista completa de campos que puedes agregar a, consulta spec.statefulSet.spec.template.spec la documentación de Kubernetes.

El siguiente ejemplo spec.statefulSet.spec.template.spec define la capacidad mínima y máxima de CPU y memoria para un contenedor de Ops Manager que implementa el operador de MongoDB Controllers for Kubernetes:

Tip

Para obtener más información sobre los requisitos de hardware, software y red 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-ops-manager
resources:
requests:
cpu: "4"
memory: "16Gi"
limits:
cpu: "8"
memory: "32Gi"
spec.statefulSet.spec.template.spec.containers

Tipo: colección

Lista de contenedores que pertenecen a los pods de Kubernetes en el StatefulSet que el operador de controladores MongoDB para Kubernetes crea para Ops Manager.

Para modificar las especificaciones del contenedor de Ops Manager, debe proporcionar el nombre exacto del contenedor utilizando el campo name, como se muestra en el siguiente ejemplo:

backup:
statefulSet:
spec:
template:
spec:
containers:
- name: mongodb-ops-manager

Nota

Al agregar contenedores a spec.statefulSet.spec.template.spec.containers, el operador de Kubernetes los agrega al pod de Kubernetes. Estos contenedores se agregan a los contenedores de Ops Manager en el pod.

spec.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 Ops Manager.

El valor solicitado debe ser menor o igual a spec.statefulSet.spec.template.spec.containers.resources.limits.cpu.

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

Tipo: string

Capacidad máxima de CPU del nodo que se crea para alojar el Administrador de Operaciones. Si se omite, este valor se establece spec.statefulSet.spec.template.spec.containers.resources.requests.cpu en.

spec.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 Ops Manager en Kubernetes. Este valor se expresa como un entero seguido de una unidad de memoria en notación JEDEC.

Ejemplo

Si Ops Manager en Kubernetes requiere 6 gigabytes de memoria, configure este valor en 6Gi.

Nota

MongoDB recomienda establecer este valor al menos en 5Gi.

El valor solicitado debe ser menor o igual a spec.statefulSet.spec.template.spec.containers.resources.limits.memory.

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

Tipo: string

Capacidad máxima de memoria del nodo que se crea para alojar el Administrador de Operaciones. Si se omite, este valor se establece spec.statefulSet.spec.template.spec.containers.resources.requests.memory en.

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

Advertencia

Limite este valor a menos de 32 GB

Configurar este valor en un valor superior a 32 GB (32Gi) puede causar problemas con el servicio de copia de seguridad. Un montón excesivo puede generar resultados impredecibles en Ops Manager.

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 con Ops Manager. Si se proporciona, el operador de Kubernetes crea un servicio de Kubernetes que permite que el tráfico procedente de fuera 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 usar 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 tipo de servicio del servicio Kubernetes que expone Ops Manager fuera de Kubernetes.

Obligatorio si está spec.externalConnectivity.type presente.

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

spec.externalConnectivity.port

Tipo: entero

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

  • Si spec.externalConnectivity.type NodePortes:

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

    • Si no proporciona un valor, el servicio Kubernetes enruta el tráfico a la aplicación Ops Manager desde un puerto disponible seleccionado aleatoriamente del siguiente rango spec.externalConnectivity.port predeterminado: 3000032767-.

      Nota

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

  • Si spec.externalConnectivity.type LoadBalanceres:

    • El recurso de balanceador de carga que crea su proveedor de nube expone la aplicación 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 utiliza el servicio Kubernetes LoadBalancer cuando el operador de Kubernetes lo crea.

Esta configuración solo se puede usar si tu proveedor de nube la admite spec.externalConnectivity.type y LoadBalancer es. Para obtener más información sobre el equilibrador de carga de tipo, consulta la documentación de Kubernetes.

spec.externalConnectivity.externalTrafficPolicy

Tipo: string

Política de enrutamiento para el tráfico externo al servicio Ops Manager de Kubernetes. El servicio enruta el tráfico externo a puntos finales locales del nodo o a nivel de clúster, según el valor de esta configuración.

Los valores aceptados son: Cluster Localy. Para saber cuáles cumplen con sus requisitos, consulte "IP de origen en Kubernetes" en la documentación de Kubernetes.

Nota

Si selecciona Cluster, los Source-IP de sus clientes se perderán 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 las anotaciones y la compatibilidad con TLS en AWS, consulte la documentación de Kubernetes.

Esta sección describe las opciones de configuración para las copias de seguridad en Ops Manager. Para conocer las opciones de configuración específicas de su implementación multiclúster de Ops Manager, consulte Configuración multiclúster.

spec.backup.assignmentLabels

Tipo: arreglo de cadenas

Una lista de etiquetas de asignación para los procesos del servicio Backup Daemon. Use etiquetas de asignación para identificar qué procesos específicos del servicio Backup Daemon están asociados a proyectos específicos. Si configura etiquetas de asignación con el operador de Kubernetes, los valores que configure 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 configure con el operador de Kubernetes seguirán usando los valores definidos en la interfaz de usuario de Ops Manager.

spec.backup.enabled

Tipo: booleano

Marca que habilita la copia de seguridad para tu recurso de Ops Manager. Cuando se establece en false, la copia de seguridad se deshabilita.

El valor predeterminado es true.

spec.backup.encryption

Tipo: objeto

Objeto que contiene la configuración de cifrado de respaldo.

spec.backup.encryption.kmip

Tipo: objeto

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

Nota

Si establece este parámetro, la clave API vinculada con el valor de debe spec.credentials Global Owner tener el rol.

spec.backup.encryption.kmip.server

Tipo: objeto

Objeto que contiene la configuración del servidor de cifrado de respaldo 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 () que seca.pem utilizará para la autenticación KMIP.

spec.backup.encryption.kmip.server.url

Tipo: string

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

spec.backup.headDB

Tipo: colección

Configuración de la base de datos principal. El operador de Kubernetes crea una reclamación 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 del volumen persistente que debe montarse. Este valor se expresa como un entero seguido de una unidad de almacenamiento en notación JEDEC.

El valor predeterminado es 30Gi.

Para obtener más información, consulte Requisitos de hardware del demonio de respaldo.

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 una notificación de volumen persistente. Puede crear este tipo de almacenamiento como un objeto StorageClass antes de usarlo en esta especificación de objeto.

Asegúrese de configurar la clase de almacenamiento reclaimPolicy en Retener. Esto garantiza que los datos se conserven al eliminar una reclamación de volumen persistente.

spec.backup.jvmParameters

Tipo: arreglo de cadenas

Opcional. Parámetros de JVM pasados ​​al servicio derespaldo de Ops Manager en el contenedor.

Este parámetro del operador de Kubernetes tiene como valor predeterminado una lista vacía.

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

Advertencia

Cambie los valores del montón de memoria JVM bajo su propio riesgo

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

spec.backup.members

Tipo: entero

Opcional. Número de servicios de daemon de copias de seguridad para implementar en Kubernetes. Si no se especifica, el valor por defecto es 1. Para garantizar la alta disponibilidad de su servicio de copia de seguridad, implemente múltiples demonios de copias de seguridad en Ops Manager.

spec.backup.opLogStores

Tipo: colección

Obligatorio si habilita la copia de seguridad. Matriz de almacenes de registros de operaciones utilizada para la copia de seguridad. Cada elemento de la matriz hace referencia a un recurso de base de datos MongoDB implementado en el clúster de Kubernetes por el operador de Kubernetes.

spec.backup.opLogStores.assignmentLabels

Tipo: arreglo de cadenas

Una lista de etiquetas de asignación para el almacén de registros de operaciones. Use etiquetas de asignación para identificar qué almacenes de registros de operaciones están asociados a proyectos específicos. Si configura etiquetas de asignación con el operador de Kubernetes, los valores que configure 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 configure con el operador de Kubernetes seguirán usando los valores definidos en la interfaz de usuario de Ops Manager.

spec.backup.opLogStores.name

Tipo: string

Obligatorio si habilita la copia de seguridad. Nombre del almacén de registros de operaciones.

Importante

Una vez especificado, no edite el nombre del almacén de oplog.

spec.backup.opLogStores.mongodbResourceRef.name

Tipo: string

Obligatorio si habilita la copia de seguridad. Nombre del MongoDB recurso o MongoDBMultiCluster que crea para almacenar fragmentos de registro de operaciones. Debe implementar este recurso en el mismo espacio de nombres que el recurso de Ops Manager.

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

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

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

  • Especifique el del usuario en la definición de recurso de Ops name Manager.

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

Nota

El operador de Kubernetes comienza a conciliar automáticamente el recurso de Ops Manager al realizar cambios de seguridad en los recursos de la base de datos a los que hace referencia en esta configuración. El operador de Kubernetes actualiza los indicadores mongoURI y ssl en la configuración de Ops Manager según los 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:

spec.backup.blockStores

Tipo: colección

Obligatorio si habilita la copia de seguridad mediante un almacén de bloques. Matriz de almacenes de bloques utilizada para la copia de seguridad. Cada elemento de la matriz hace referencia a un recurso de base de datos MongoDB implementado 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 almacén de bloques. Use etiquetas de asignación para identificar qué almacenes de bloques específicos están asociados a proyectos específicos. Si configura etiquetas de asignación con el operador de Kubernetes, los valores que configure en el archivo de configuración de Kubernetes para las etiquetas de asignación anulan los valores definidos en la interfaz de Ops Manager. Las etiquetas de asignación que no configure con el operador de Kubernetes seguirán usando los valores definidos en la interfaz de Ops Manager.

spec.backup.blockStores.name

Tipo: string

Obligatorio si habilita la copia de seguridad mediante un almacén de bloques. Nombre del almacén de bloques.

Importante

Una vez especificado, no edite el nombre del almacén de bloques.

spec.backup.blockStores.mongodbResourceRef.name

Tipo: string

Obligatorio si habilita la copia de seguridad mediante un almacén de bloques. Nombre del recurso de base de datos MongoDB que crea para el almacén de bloques. Debe implementar este recurso de base de datos en el mismo espacio de nombres 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 del almacén de bloques, debe:

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

  • Especifique el del usuario en la definición de recurso de Ops name Manager.

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

Nota

El operador de Kubernetes comienza a conciliar automáticamente el recurso de Ops Manager al realizar cambios de seguridad en los recursos de la base de datos a los que hace referencia en esta configuración. El operador de Kubernetes actualiza los indicadores mongoURI y ssl en la configuración de Ops Manager según los cambios.

spec.backup.blockStores.mongodbUserRef.name

Tipo: string

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

spec.backup.queryableBackupSecretRef.name

Tipo: string

Nombre del secreto que contiene el archivo queryable.pem de Ops Manager, que se usará para acceder y consultar las copias de seguridad según los requisitos TLS de su implementación. El archivo PEM contiene un certificado de clave pública y su clave privada asociada, necesarios para acceder y ejecutar consultas en las instantáneas de copia de seguridad en Ops Manager. Para consultar las copias de seguridad, especifique el valor de este parámetro. Si no se configura, las copias de seguridad no se verán afectadas, pero no podrá consultarlas.

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.

Para revisar qué campos puedes agregar spec.backup.statefulSet.spec a, consulta las aplicaciones StatefulSetSpec v1 en la documentación de Kubernetes.

spec.backup.statefulSet.spec.template

Tipo: colección

Plantilla para los pods de Kubernetes en el StatefulSet que el operador de controladores MongoDB para Kubernetes crea para el servicio de demonio de respaldo.

Nota

El operador de Kubernetes no valida los campos que proporciona spec.backup.statefulSet.spec.template en.

spec.backup.statefulSet.spec.template.metadata

Tipo: colección

Metadatos para los pods de Kubernetes en el StatefulSet que el operador de controladores MongoDB para Kubernetes crea para el servicio de demonio de respaldo.

Para revisar qué campos puedes agregar a, consulta spec.backup.statefulSet.spec.template.metadata la documentación de Kubernetes.

spec.backup.statefulSet.spec.template.spec

Tipo: colección

Especificaciones de los pods de Kubernetes en el StatefulSet que el operador de controladores MongoDB para Kubernetes crea para el servicio de demonio de respaldo.

Para revisar la lista completa de campos que puedes agregar a, consulta spec.backup.statefulSet.spec.template.spec la documentación de Kubernetes.

El siguiente ejemplo spec.backup.statefulSet.spec.template.spec define la capacidad mínima y máxima de CPU y memoria para un contenedor de servicio de demonio de respaldo que implementa el operador de MongoDB Controllers for Kubernetes:

Tip

Para obtener más información sobre los requisitos de hardware, software y red 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.

Para modificar las especificaciones del contenedor del servicio de demonio de respaldo, debe proporcionar el nombre exacto del contenedor utilizando el name campo, como se muestra en el siguiente ejemplo:

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

Nota

Al agregar contenedores spec.backup.statefulSet.spec.template.spec.containers a, el operador de Kubernetes los agrega al pod de Kubernetes. Estos contenedores se agregan a los contenedores del servicio Backup Daemon del 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 serviciode demonio de respaldo.

El valor solicitado debe ser menor o igual a spec.backup.statefulSet.spec.template.spec.containers.resources.limits.cpu.

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

Tipo: string

Capacidad máxima de CPU del nodo que se crea para alojar el servicio de demonio de copia de seguridad. Si se omite, este valor se establece spec.backup.statefulSet.spec.template.spec.containers.resources.requests.cpu en.

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 demonio de copia de seguridad en Kubernetes. Este valor se expresa como un 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.

El valor solicitado debe ser menor o igual a spec.backup.statefulSet.spec.template.spec.containers.resources.limits.memory.

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

Tipo: string

Capacidad máxima de memoria del nodo que se crea para alojar el servicio de demonio de copia de seguridad. Si se omite, este valor se establece spec.backup.statefulSet.spec.template.spec.containers.resources.requests.memory en.

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

Advertencia

Limite este valor a menos de 32 GB

Configurar este valor en un valor superior a 32 GB (32Gi) puede causar problemas con el servicio de copia de seguridad. Un montón excesivo puede generar resultados impredecibles en Ops Manager.

Puede configurar Ops Manager para usar S3 para almacenar registros de operaciones e instantáneas de respaldo, y proteger conexiones a S3 con TLS usando claves emitidas por CA personalizada.

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

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

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

  • Para utilizar TLS solo para S,3 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 3 almacenes de registros de operaciones S. Use etiquetas de asignación para identificar qué almacenes de registros de operaciones S están asociados a3 proyectos específicos. Si configura etiquetas de asignación mediante el operador de Kubernetes, los valores que configure 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 configure mediante el operador de Kubernetes seguirán usando los valores definidos en la interfaz de usuario de Ops Manager.

spec.backup.s3OpLogStores.customCertificate

Tipo: booleano

Obsoleto. Utiliza spec.backup.s3OpLogStores.customCertificateSecretRefs en su lugar.

Marca que indica si se utilizan certificadosappdb-ca de AppDB () como certificado TLS personalizado para el3 almacén de registros de operaciones S. El valor predeterminado False es.

spec.backup.s3OpLogStores.customCertificateSecretRefs

Tipo: matriz de objetos

Lista de certificados personalizados para su almacén de oplog S3 usando secretos de Kubernetes. El certificado x.509 codificado en base64debe estar presente en un secreto de Kubernetes con una clave y debe ser parseable por el Java CertifcateFactory. No puedes especificar múltiples certificados en una cadena en un solo secreto. Si especificas múltiples certificados en una cadena en un solo secreto, el operador de Kubernetes utiliza solo el primer certificado en la cadena. Si también proporciona la configuración customCertificate, el operador de Kubernetes usa el spec.applicationDatabase.security.tls.ca como certificado personalizado para copias de seguridad.

Cada entrada de la lista especifica y. Si especifica varios secretos, Kubernetes Operator utiliza todos los certificados de los secretos name keyespecificados.

Si no proporciona esta configuración, Ops Manager utiliza el almacén de confianza predeterminado de JVM utilizado por Ops Manager.

spec.backup.s3OpLogStores.customCertificateSecretRefs.name

Tipo: string

Necesario para usar certificados personalizados en el almacén de registros de3 operaciones S. Secreto de Kubernetes que contiene el certificado personalizado.

spec.configuration.mms.mongoDbUsage.defaultUsageType

Tipo: string

El tipo de servidor predeterminado del servicio Kubernetes.

spec.backup.s3OpLogStores.customCertificateSecretRefs.key

Tipo: string

Necesario para usar certificados personalizados para el3 almacén de registros de operaciones S. Archivo que representa la clave del secreto que contiene el64509 certificado x. codificado en base. Si no se especifica esta configuración, el operador de Kubernetes no podrá usar el certificado personalizado para las copias de seguridad del 3 almacén de registros de operaciones S.

spec.backup.s3OpLogStores.irsaEnabled

Tipo: booleano

Flag que permite usar AWS roles IAM para cuentas de servicio en AWS EKS para configurar un almacén de S3 oplog. El valor por defecto es False. Si no utilizas AWS EKS, esta bandera no tiene efecto. Cuando se configura en False, el uso de roles IAM de AWS para cuentas de servicio en EKS para configurar un almacén de S3 oplog está deshabilitado. Para aprender más, consulta Roles IAM para cuentas de servicio en EKS.

spec.backup.s3OpLogStores.name

Tipo: string

Necesario para almacenar el registro de operaciones mediante un almacén S.3 Nombre del almacén 3 S.

spec.backup.s3OpLogStores.mongodbResourceRef.name

Tipo: string

Nombre del recurso de base de datos MongoDB que crea para almacenar metadatos para el almacén de registros de operaciones S. Debe implementar este recurso de base de datos en el mismo espacio de nombres que el recurso Ops 3 Manager.

Nota

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

Si omite esta configuración, también debe omitir la configuración de spec.backup.s3OpLogStores.mongodbUserRef.name. El operador de Kubernetes gestiona la autenticación de usuarios de SCRAM internamente.

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

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

  • Especifique el del usuario en la definición de recurso de Ops name Manager.

spec.backup.s3OpLogStores.mongodbUserRef.name

Tipo: string

Obligatorio si creó un recurso de base de datos MongoDB para almacenar3 metadatos del registro de operaciones S y SCRAM está habilitado en esta base de datos. Nombre del recurso de usuario MongoDB utilizado para conectarse a la base de datos de metadatos del almacén de 3 registros de operaciones S. Implemente este recurso de usuario en el mismo espacio de nombres que el recurso Ops Manager y con todos los roles siguientes:

Importante

Una vez especificado, no edite el nombre de usuario del almacén de registros de operaciones de metadatos S.3

spec.backup.s3OpLogStores.s3SecretRef.name

Tipo: string

Es necesario almacenar el registro de operaciones mediante un almacenamiento S3 si spec.backup.s3OpLogStores.irsaEnabled no está configurado en true.

Nombre del secreto que contiene los accessKey secretKey campos y. El servicio de demonio de copia de seguridad utiliza los valores de estos campos como credenciales para acceder a su bucket compatible con AWS S3 o S. Para3 configurar el almacén3 de registros de operaciones S, 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 punto final del bucket.

Valor
Descripción
Ejemplo

true

URL de estilo de ruta

s3.amazonaws.com/<bucket>

false

URL de estilo de host virtual

<bucket>.s3.amazonaws.com

Para obtener más información sobre las anotaciones y la compatibilidad con TLS en AWS, consulte la documentación de Kubernetes.

El valor predeterminado es true.

spec.backup.s3OpLogStores.s3BucketEndpoint

Tipo: string

Necesario para almacenar el registro de operaciones mediante un3 almacén S. URL del depósito AWS S3 o del depósito compatible con S que aloja el almacén del registro de operaciones.3

Nota

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

spec.backup.s3OpLogStores.s3BucketName

Tipo: string

Necesario para almacenar el registro de operaciones mediante un almacén S.3 Nombre del depósito AWS S3 o del depósito compatible con S que aloja el almacén del registro de operaciones.3

spec.backup.s3OpLogStores.s3RegionOverride

Tipo: string

Región donde reside su bucket compatible con S. Use este campo solo si el de su almacén 3de registros de s3BucketEndpoint operaciones S3no admite el alcance regional. El alcance regional se produce cuando su punto de conexión no incluye una región en su URL.

No utilice este campo con buckets de AWS S.3 Para obtener más información, consulte 3 Configuración del almacén de bloques S.

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 instantáneas de copia de seguridad de la base de datos. Use etiquetas de asignación para identificar qué almacenes S3 específicos están asociados a proyectos específicos. Si configura etiquetas de asignación con el operador de Kubernetes, los valores que configure 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 configure con el operador de Kubernetes seguirán usando los valores definidos en la interfaz de usuario de Ops Manager.

spec.backup.s3Stores.customCertificate

Tipo: booleano

Obsoleto. Utiliza spec.backup.s3Stores.customCertificateSecretRefs en su lugar.

Marca que indica si se utilizan los certificadosappdb-ca de la base de datos de la aplicación () como certificado TLS personalizado para las copias de seguridad de S. El valor predeterminado3 False es.

spec.backup.s3Stores.customCertificateSecretRefs

Tipo: matriz de objetos

Lista de certificados personalizados para su almacén de instantáneas S3 que utiliza secretos de Kubernetes.64El509 certificado x. con codificación base debe estar presente en un secreto de Kubernetes con una clave y debe ser analizable por Java CertifcateFactory. No se pueden especificar varios certificados en una cadena dentro de un mismo secreto. Si se especifican varios certificados en una cadena dentro de un mismo secreto, Kubernetes Operator solo usa el primer certificado de la cadena. Si también se proporciona la spec.backup.s3Stores.customCertificate configuración, Kubernetes Operator usa spec.applicationDatabase.security.tls.ca como certificado personalizado para las copias de seguridad.

Cada entrada de la lista especifica y. Si especifica varios secretos, el operador de Kubernetes los usa name keytodos.

Si no proporciona esta configuración, el operador de Kubernetes utiliza el almacén de confianza predeterminado de JVM que utiliza Ops Manager para las copias de seguridad.

spec.backup.s3Stores.customCertificateSecretRefs.name

Tipo: string

Necesario para usar certificados personalizados en el almacén de registros de3 operaciones S. Secreto de Kubernetes que contiene el certificado personalizado.

spec.backup.s3Stores.customCertificateSecretRefs.key

Tipo: string

Requerido para usar certificados personalizados para tu almacenamiento S3 oplog. Archivo que representa la clave en el secreto que contiene el certificado codificado en base64-x.509. Si no se especifica este ajuste, el operador de Kubernetes no puede utilizar el certificado personalizado para el almacenamiento de snapshot S3 y recurre al almacén de confianza JVM {Java Virtual Machine) por defecto utilizado por Ops Manager.

spec.backup.s3Stores.irsaEnabled

Tipo: booleano

Marca que habilita el uso de roles de IAM de AWS para cuentas de servicio en AWS EKS para configurar un almacén3 de instantáneas S. El valor predeterminado False es. Si no utiliza AWS EKS, esta marca no tiene efecto. Cuando se establece en, se deshabilita el False uso de roles de IAM de AWS para cuentas de servicio en EKS para configurar un3 almacén de instantáneas S. Para obtener más información, consulte Roles de IAM para cuentas de servicio en EKS.

spec.backup.s3Stores.name

Tipo: string

Necesario para almacenar el registro de operaciones mediante un almacén S.3 Nombre del 3 almacén de instantáneas S.

Importante

Una vez especificado, no edite el nombre del 3 almacén de instantáneas S. Es probable que este cambio falle si las copias de seguridad usan el nombre anterior. Las consecuencias de un cambio exitoso son impredecibles.

spec.backup.s3Stores.mongodbResourceRef.name

Tipo: string

Nombre del recurso MongoDB o recurso MongoDBMultiCluster que crees para almacenar metadatos para el almacén de snapshots de S3. Debes implementar este recurso de base de datos en el mismo namespace que el recurso Ops Manager.

Nota

Omita esta configuración para utilizar la base de datos de la aplicación para almacenar metadatos para el almacén3 de instantáneas S.

Si omite esta configuración, también debe omitir la configuración de spec.backup.s3Stores.mongodbUserRef.name. El operador de Kubernetes gestiona la autenticación de usuarios de SCRAM internamente.

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

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

  • Especifique el del usuario en la definición de recurso de Ops name Manager.

Importante

Una vez especificado, no edite el nombre del 3 almacén de instantáneas S. Es probable que este cambio falle si las copias de seguridad usan el nombre anterior. Las consecuencias de un cambio exitoso son impredecibles.

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

Nota

El operador de Kubernetes comienza a conciliar automáticamente el recurso de Ops Manager al realizar cambios de seguridad en los recursos de la base de datos a los que hace referencia en esta configuración. El operador de Kubernetes actualiza los indicadores mongoURI y ssl en la configuración de Ops Manager según los cambios.

spec.backup.s3Stores.mongodbUserRef.name

Tipo: string

Obligatorio si creó un recurso de base de datos MongoDB para almacenar3metadatos de instantáneas |s | y SCRAM está habilitado en esta base de datos. Nombre del recurso de usuario MongoDB utilizado para conectarse a la base de datos de metadatos del 3 almacén de instantáneas S. Implemente este recurso de usuario en el mismo espacio de nombres que el recurso Ops Manager y con todos los roles siguientes:

Importante

Una vez especificado, no edite el nombre de usuario del almacén de instantáneas de metadatos S.3

spec.backup.s3Stores.s3SecretRef.name

Tipo: string

Obligatorio si habilita la copia de seguridad mediante un almacén S3 y no configura spec.backup.s3Stores.irsaEnabled en true.

Nombre del secreto que contiene los accessKey secretKey campos y. El servicio de demonio de copia de seguridad utiliza los valores de estos campos como credenciales para acceder a su bucket compatible con3 AWS S3o S. El almacén de instantáneas S no se puede configurar si al secreto le falta alguna de las claves.3

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 punto final del bucket.

Valor
Descripción
Ejemplo

true

URL de estilo de ruta

s3.amazonaws.com/<bucket>

false

URL de estilo de host virtual

<bucket>.s3.amazonaws.com

El valor predeterminado es true.

spec.backup.s3Stores.s3BucketEndpoint

Tipo: string

Obligatorio si habilita3 la copia de seguridad mediante un almacén S. URL del depósito AWS S3 o del depósito compatible con S que aloja el almacén de instantáneas.3

Nota

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

spec.backup.s3Stores.s3BucketName

Tipo: string

Obligatorio si habilita la copia de seguridad mediante un almacén S.3 Nombre del depósito de AWS S3 o del depósito compatible con S que aloja el almacén de instantáneas.3

spec.backup.s3Stores.s3RegionOverride

Tipo: string

Región donde reside su bucket compatible con S. Use este campo solo si el de su3almacén s3BucketEndpoint S3no admite el alcance regional. El alcance regional se produce cuando su punto de conexión no incluye una región en su URL.

No utilice este campo con buckets de AWS S.3 Para obtener más información, consulte 3 Configuración del almacén de bloques S.

En esta sección se describen las configuraciones que debe utilizar además de las configuraciones requeridas de Ops Manager para configurar la base de datos de la aplicación Ops Manager.

spec.applicationDatabase.version

Tipo: string

Obligatorio. Versión de MongoDB instalada en la base de datos de la aplicación Ops Manager. Debe especificar una versión empresarial de MongoDB compatible según la etiqueta en el registro de contenedores. Por ejemplo,. 8.0.0-ubi8 A partir de la versión. del operador de Kubernetes,1 20las etiquetas ya no terminan -ent en.

Importante

Asegúrese de elegir una versión de MongoDB Server compatible.

Las versiones compatibles difieren según la imagen base que utiliza el recurso de base de datos MongoDB.

Nota

Si actualiza este valor a una versión posterior de MongoDB para la base de datos de la aplicación, la versión de compatibilidad de funciones se mantendrá en la versión de MongoDB que está actualizando para que pueda cambiar a una versión inferior si es necesario. Si desea que la versión de compatibilidad de funciones coincida con la nueva versión de MongoDB, debe configurar manualmente el featureCompatibilityVersion parámetro spec.applicationDatabase en.

Esta sección describe las opciones de configuración de la base de datos de la aplicación Ops Manager. Para obtener información sobre la configuración opcional de la base de datos de la aplicación específica para su implementación multiclúster de Ops Manager, consulte Configuración multiclúster.

spec.applicationDatabase

Tipo: colección

Definición de recursos de base de datos de la aplicación Ops Manager.

Las siguientes configuraciones de la especificación de recursos del conjunto de réplicas son opcionales.

spec.applicationDatabase.agent.logLevel

Tipo: string

Predeterminado: INFO

Configura el nivel de registro del agente de automatización dentro del pod. Los valores aceptados incluyen:

  • DEBUG

  • INFO

  • WARN

  • ERROR

  • FATAL

spec.applicationDatabase.agent.<component>.logRotate

Tipo: objeto

Reemplace el componente con uno de los siguientes valores:

  • mongod

  • monitoringAgent

Objeto de configuración de MongoDB para rotar los registros de MongoDB de un proceso. Para usar la agent.<component>.logRotate configuración, debe establecer systemLog.destination en,file ya que no puede usar la agent.<component>.logRotate configuración si escribe registros en el sistema syslog del host.

spec.applicationDatabase.agent.mongod.logRotate.numTotal

Tipo: entero

Por defecto: 0

Número total de archivos de registro que Ops Manager conserva. Si no cambia la configuración predeterminada, Ops Manager basa la rotación en sus otras agent.<compenet>.logRotate configuraciones.

spec.applicationDatabase.agent.mongod.logRotate.numUncompressed

Tipo: entero

Por defecto: 5

Número máximo de archivos de registro totales que se dejarán sin comprimir, incluido el archivo de registro actual.

spec.applicationDatabase.agent.mongod.logRotate.percentOfDiskspace

Tipo: número

Por defecto: 0.02

Porcentaje máximo del espacio total en disco que Ops Manager puede usar para almacenar los archivos de registro, expresado en decimales. Si se supera estelímite, Ops Manager elimina los archivos de registro comprimidos hasta alcanzarlo. Ops Manager elimina primero los archivos de registro más antiguos.

spec.applicationDatabase.agent.<component>.logRotate.sizeThresholdMB

Tipo: número

Reemplace el componente con uno de los siguientes valores:

  • mongod

  • monitoringAgent

Obligatorio si se rotan registros. Tamaño máximo en MB para un archivo de registro individual antes de que Ops Manager lo rote. Ops Manager rota el archivo de registro inmediatamente si cumple con el valor especificado en este sizeThresholdMB logRotate.timeThresholdHrs límite o.

spec.applicationDatabase.agent.<component>.logRotate.timeThresholdHrs

Tipo: entero

Reemplace el componente con uno de los siguientes valores:

  • mongod

  • monitoringAgent

Obligatorio si se rotan registros. Duración máxima en horas para un archivo de registro individual antes de la siguiente rotación. El tiempo transcurrido es desde la última rotación. Ops Manager rota el archivo de registro inmediatamente si cumple con el valor especificado en timeThresholdHrs o el logRotate.sizeThresholdM límite de.

spec.applicationDatabase.agent.mongod.auditlogRotate

Tipo: objeto

Objeto de configuración de MongoDB para rotar los registros de auditoría de MongoDB de un proceso.

spec.applicationDatabase.agent.mongod.auditlogRotate.numTotal

Tipo: entero

Por defecto: 0

Número total de archivos de registro de auditoría que Ops Manager conserva. Si no cambia el valor predeterminado, Ops Manager basará la rotación en sus otras agent.mongod.auditlogRotate configuraciones.

spec.applicationDatabase.agent.mongod.auditlogRotate.numUncompressed

Tipo: entero

Por defecto: 5

Número máximo de archivos de registro de auditoría totales que se dejarán sin comprimir, incluido el archivo de registro de auditoría actual.

spec.applicationDatabase.agent.mongod.auditlogRotate.percentOfDiskspace

Tipo: número

Por defecto: 0.02

Porcentaje máximo del espacio total en disco que Ops Manager puede usar para almacenar los archivos de registro de auditoría, expresado en decimales. Si se supera este límite, Ops Manager eliminará los archivos de registro de auditoría comprimidos hasta alcanzarlo. Ops Manager eliminará primero los archivos de registro de auditoría más antiguos.

spec.applicationDatabase.agent.mongod.auditlogRotate.sizeThresholdMB

Tipo: número

Obligatorio si se rotan los registros de auditoría. Tamaño máximo en MB para un archivo de registro de auditoría individual antes de que Ops Manager lo rote. Ops Manager rota el archivo de registro de auditoría inmediatamente si alcanza el valor en sizeThresholdMB o el límite auditlogRotate.timeThresholdHrs de.

spec.applicationDatabase.agent.mongod.auditlogRotate.timeThresholdHrs

Tipo: entero

Obligatorio si se rotan los registros de auditoría. Duración máxima en horas de un archivo de registro de auditoría individual antes de la siguiente rotación. El tiempo transcurrido es desde la última rotación. Ops Manager rota el archivo de registro de auditoría inmediatamente si alcanza el valor en el timeThresholdHrs auditlogRotate.sizeThresholdM límite o.

spec.applicationDatabase.agent.startupOptions

Tipo: objeto

Objeto de configuración de MongoDB para las opciones de inicio. Consulte la configuración del agente de MongoDB para ver los campos disponibles.

spec.applicationDatabase.agent.systemLog

Tipo: objeto

Objeto de configuración de MongoDB para configurar las opciones systemLog.

spec.applicationDatabase.agent.systemLog.path

Tipo: string

Por defecto: /var/log/mongodb-mms-automation/mongodb.log

La ruta del archivo de registro al que mongod o deben enviar toda la información de registro de mongos diagnóstico, en lugar de la salida estándar o el syslog del host. MongoDB crea el archivo de registro en la ruta especificada.

Los scripts de inicio de los paquetes de Linux no esperan que systemLog.path cambie de los valores predeterminados. Si usa los paquetes de Linux y cambia systemLog.path, deberá usar sus propios scripts de inicio y deshabilitar los scripts integrados.

spec.applicationDatabase.agent.systemLog.logAppend

Tipo: booleano

Por defecto: false

Cuando,true mongos u añade nuevas entradas al final mongod mongos del mongod archivo de registro existentemongod al reiniciar la instancia o. Sin esta opción, creará una copia de seguridad del registro existente y creará un nuevo archivo.

spec.applicationDatabase.agent.systemLog.destination

Tipo: string

El destino al que MongoDB envía todos los registros de salida. Especifica file o syslog. Si especificas file, también debes especificar systemLog.path.

Si no especifica, MongoDB envía toda la salida del registro a la salida systemLog.path estándar.

Advertencia

El demonio syslog genera marcas de tiempo al registrar un mensaje, no cuando MongoDB lo emite. Este comportamiento puede generar marcas de tiempo erróneas en las entradas de registro, especialmente cuando el sistema está sometido a una gran carga. Recomendamos usar la opción file en sistemas de producción para garantizar la precisión de las marcas de tiempo.

spec.applicationDatabase.externalAccess

Tipo: colección

Especificación para exponer su clúster a conexiones externas. Para saber cómo conectarse a su recurso MongoDB desde fuera del clúster de Kubernetes, consulte Conectarse a un recurso de base de datos MongoDB desde fuera de Kubernetes.

Si spec.externalAccess agrega, el operador de Kubernetes crea un servicio externo para cada pod de un conjunto de réplicas. Los servicios externos proporcionan un punto de entrada externo para cada pod de base de datos MongoDB de un clúster. Cada servicio externo tiene selectores que lo asocian a un pod específico.

Si agrega esta configuración sin ningún valor, el operador de Kubernetes crea un servicio externo con los siguientes valores predeterminados:

Campo
Valor
Descripción

Name

<pod-name>-svc-external

Nombre del servicio externo. No se puede cambiar este valor.

Type

LoadBalancer

Crea un servicio LoadBalancer externo.

Port

<Port Number>

Un puerto mongod para.

publishNotReadyAddress

true

Especifica que los registros DNS se crean incluso si el pod no está listo. No se establece en false para ningún pod de base de datos.

spec.externalAccess.externalService

Tipo: colección

Especificación para anular los valores predeterminados spec.externalAccess en.

Al configurar el parámetro, el operador de Kubernetes crea automáticamente spec.externalAccess un servicio de balanceador de carga externo con valores predeterminados. Puede anular ciertos valores o añadir nuevos según sus necesidades. Por ejemplo, si desea crear servicios NodePort y no necesita un balanceador de carga, debe configurar las anulaciones en su especificación de Kubernetes:

externalAccess:
externalService:
annotations:
# cloud-specific annotations for the service
spec:
type: NodePort # default is LoadBalancer
# you can specify other spec overrides if necessary

Para obtener más información sobre la especificación de Kubernetes, consulte ServiceSpec en la documentación de Kubernetes.

spec.externalAccess.externalService.annotations

Tipo: colección

Pares clave-valor que permiten agregar opciones de configuración específicas del proveedor de nube a todos los clústeres de la implementación. Para obtener más información,consulte las anotaciones y la documentación de su proveedor de nube de Kubernetes.

Puede usar anotaciones para especificar valores de marcador de posición para los servicios externos que utilizan las implementaciones del Operador de Kubernetes. El Operador de Kubernetes reemplaza automáticamente estos valores por los correctos, como se describe en la siguiente tabla. El uso de marcadores de posición permite proporcionar anotaciones específicas en cada servicio para un pod específico.

Valor
Descripción

{resourceName}

{namespace}

{podIndex}

Índice del Pod asignado por StatefulSet y al que apunta el servicio externo actual.

{podName}

Igual a {resourceName}-{podIndex}.

{statefulSetName}

El conjunto con estado.Igual {resourceName} a.

{externalServiceName}

Nombre generado del servicio externo, basado en los valores de marcador de posición especificados. Igual a {resourceName}-{podIndex}-svc-external.

{mongodProcessDomain}

El nombre de dominio del servidor que aloja el proceso mongod. Igual a spec.externalAccess.externalDomain si se establece. De lo contrario, igual al dominio utilizado para el proceso mongod FQDN.

Por ejemplo, para el nombre de host del proceso mdb-rs-1.example.com, example.com es el nombre de dominio.

{mongodProcessFQDN}

El mongod nombre de host del proceso establecido en la configuración de automatización.

El nombre de host del proceso depende de la configuración de su implementación. Si ha configurado su implementación para usar, el nombre de host del proceso tendrá el siguiente external domains formato:

{resourceName}-{podIndex}.{mongodProcessDomain}

Por ejemplo: mdb-rs-1.example.com

Si su implementación no utiliza dominios externos, el nombre de host del proceso utiliza el siguiente formato:

{resourceName}-{podIndex}.{resourceName}-{podIndex}-svc.{namespace}.svc.cluster.local

Por ejemplo: mdb-rs-1.mdb-rs-1-svc.ns.svc.cluster.local

Nota

Debe usar solo valores de marcador de posición conocidos, tal como se especifica en la tabla, y asegurarse de que no contengan valores vacíos o nulos. Tampoco puede usar un marcador de posición específico para implementaciones de varios clústeres de Kubernetes para una sola implementación de recursos de MongoDB.

De lo contrario, el operador de Kubernetes devuelve un error. Por ejemplo, podría aparecer el siguiente mensaje de error:

error replacing placeholders in map with key=external-dns.alpha.kubernetes.io/hostname, value={resourceName}-{podIndex}-{unknownPlaceholder}.{clusterName}-{clusterIndex}.example.com: missing values for the following placeholders: {clusterName}, {clusterIndex}, {unknownPlaceholder}``

Ejemplo

El siguiente ejemplo especifica los marcadores de posición {resourceName}, {podIndex} y {namespace}:

apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
name: mdb-rs
namespace: ns
spec:
replicas: 3
externalAccess:
externalService:
annotations:
external-dns.alpha.kubernetes.io/hostname: {resourceName}-{podIndex}-{namespace}.example.com

El operador de Kubernetes rellena automáticamente las anotaciones de los servicios externos según el valor correcto de cada marcador de posición. Por ejemplo:

mdb-rs-0-svc-external:
annotations:
external-dns.alpha.kubernetes.io/hostname: mdb-rs-0-ns.example.com
mdb-rs-1-svc-external:
annotations:
external-dns.alpha.kubernetes.io/hostname: mdb-rs-1-ns.example.com
mdb-rs-2-svc-external:
annotations:
external-dns.alpha.kubernetes.io/hostname: mdb-rs-2-ns.example.com
spec.externalAccess.externalService.spec

Tipo: colección

Configuración de ServiceSpec. Para obtener más información,spec.externalAccess.externalService consulte.

spec.applicationDatabase.memberConfig

Tipo: matriz de objetos

Especificación para cada miembro del conjunto de réplicas de la base de datos de aplicaciones en su implementación de Ops Manager.

Importante

Si spec.topology configura MultiCluster como, use spec.applicationDatabase.clusterSpecList.memberConfig en lugar de. En una implementación de Ops Manager multiclúster, el operador de Kubernetes ignora todos los parámetros por spec.applicationDatabase.memberConfig debajo spec.applicationDatabase.memberConfig de.

El número de elementos en la memberConfig lista debe ser igual spec.applicationDatabase.members a.

El orden de los elementos en la lista memberConfig debe reflejar el orden de los miembros en el conjunto de réplicas. Por ejemplo, el primer elemento de la matriz afecta al pod en el índice 0, el segundo elemento afecta al índice 1, y así sucesivamente.

Ejemplo

Considere la siguiente especificación de ejemplo para un conjunto de réplicas de tres miembros para la base de datos de la aplicación:

spec:
applicationDatabase:
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.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 aplicaciones se convierta en el principal.

  • Para aumentar la probabilidad relativa de que un miembro del conjunto de réplicas se convierta en el principal, especifique un valor priority más alto.

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

Por ejemplo, un miembro con un memberConfig.priority de 1.5 tiene más probabilidades de convertirse en el principal que un miembro con un memberConfig.priority de 0.5.

Un miembro con un memberConfig.priority de 0 no puede ser el miembro principal. Para obtener más información, consulte Prioridad de miembros.

spec.applicationDatabase.memberConfig.tags

Tipo: mapa

Mapa de etiquetas de conjuntos de réplicas para dirigir operaciones de lectura y escritura a miembros específicos de su conjunto de réplicas de la base de datos de aplicaciones.

spec.applicationDatabase.memberConfig.votes

Tipo: número

Determina si un miembro del conjunto de réplicas de la base de datos de la aplicación puede votar en una elección. Se establece en 1 para permitir que el miembro vote. Se establece en 0 para excluir al miembro de una elección.

spec.applicationDatabase.passwordSecretKeyRef.name

Tipo: string

Nombre del secreto que contiene la contraseña del usuario de la base de datos de Ops mongodb-ops-manager Manager. Ops Manager utiliza esta contraseña para autenticarse en la base de datos de la aplicación.

spec.applicationDatabase.passwordSecretKeyRef.key

Tipo: string

Nombre del campo en el secreto que contiene la contraseña del usuario de la base de datos de Ops mongodb-ops-manager Manager. Ops Manager utiliza esta contraseña para autenticarse en la base de datos de la aplicación.

El valor por defecto es password.

spec.applicationDatabase.security.certsSecretPrefix

Tipo: string

Texto para agregar como prefijo al secreto de Kubernetes que creó y que contiene la clave TLS y el certificado de su base de datos de aplicaciones.

Debes nombrar tu secreto <prefix>-<metadata.name>-db-cert.

Para aprender a configurar su instancia de Ops Manager para que se ejecute mediante HTTPS, consulte Implementar un recurso de Ops Manager.

spec.applicationDatabase.security.tls.ca

Tipo: string

Nombre del ConfigMap de Kubernetes que contiene el archivo CA para la base de datos de la aplicación.

Importante

spec.applicationDatabase.security.tls.ca es necesario si utiliza una CA personalizada para firmar los certificados TLS de su base de datos de aplicaciones.

El operador de Kubernetes requiere que usted nombre el certificado de la base de datos de la aplicación ca-pem en ConfigMap.

La CA especificada en esta sección también se utiliza para configurar certificados TLS personalizados para el3 almacenamiento S spec.backup.s3OpLogStores.customCertificate cuando o spec.backup.s3Stores.customCertificate están configurados true en.

Esta CA firma los certificados que:

  • Los miembros del conjunto de réplicas de la base de datos de aplicaciones se utilizan para comunicarse entre sí y

  • Ops Manager utiliza para comunicarse con el set de réplicas de la base de datos de la aplicación.

Advertencia

Debe concatenar su archivo CA personalizado y toda la cadena de certificados TLS de downloads.mongodb.com para evitar que Ops Manager deje de funcionar si se reinicia la base de datos de la aplicación.

spec.applicationDatabase.security.tls.enabled

Importante

spec.security.applicationDatabase.tls.enabled Está obsoleto y se eliminará en una próxima versión. Para habilitar TLS, proporcione un valor para la spec.security.applicationDatabase.certsSecretPrefix configuración.

Cifra las comunicaciones mediante certificados TLS entre Ops Manager y la base de datos de la aplicación.

Las siguientes configuraciones se aplican cuando utiliza Prometheus con su base de datos de 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

Objeto condicional que contiene los detalles del secreto para la autenticación HTTP básica. Si desea utilizar Prometheus con la base de datos de su aplicación, debe especificar esta configuración.

spec.applicationDatabase.prometheus.passwordSecretRef.key

Tipo: string

Por defecto: "password"

Opcional. Cadena legible que identifica la clave del secreto que almacena la contraseña para la autenticación HTTP básica. Si no se especifica esta configuración, se aplica la predeterminada.

spec.applicationDatabase.prometheus.passwordSecretRef.name

Tipo: string

Condicional

Etiqueta legible que identifica el secreto que contiene la contraseña para la autenticación HTTP básica. Si desea usar Prometheus con la base de datos de su aplicación, debe 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 punto final de métricas. Si no se especifica esta configuración, se aplica el valor predeterminado.

spec.applicationDatabase.prometheus.tlseSecretKeyRef

Tipo: objeto

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

spec.applicationDatabase.prometheus.tlseSecretKeyRef.key

Tipo: string

Por defecto: "password"

Opcional. Cadena legible que identifica la clave del secreto que almacena la contraseña para la autenticación TLS. Si no se especifica esta configuración, se aplica la predeterminada.

spec.applicationDatabase.prometheus.tlseSecretKeyRef.name

Tipo: string

Condicional. Etiqueta legible que identifica el secreto que contiene la contraseña para la autenticación TLS. Si desea usar Prometheus con la base de datos de su aplicación y usar la autenticación TLS, debe especificar esta configuración.

spec.applicationDatabase.prometheus.username

Tipo: string

Condicional. Etiqueta legible que identifica al usuario para la autenticación HTTP básica. Si desea usar Prometheus con la base de datos de su aplicación, debe especificar esta configuración.

En esta sección se describen las configuraciones que debe utilizar para su implementación de Ops Manager de varios clústeres, además de las configuraciones de Ops Manager requeridas.

spec.clusterSpecList.members

Tipo: entero

Condicional. El número de miembros de Ops Manager en el clúster de Ops Manager en una implementación de MongoDB con clústeres multi-Kubernetes. Al spec.topology establecer MultiCluster en, debe especificar el valor de este parámetro. Omítalo en implementaciones de un solo clúster. Si establece este parámetro en cero, se eliminará este clúster miembro de Ops Manager de la lista de clústeres miembros en el clúster multi-Kubernetes de instancias de Ops Manager.

spec.topology

Tipo: string

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

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

  • Si especifica MultiCluster:

Los recursos de Ops Manager también pueden usar las siguientes configuraciones específicas para implementaciones de Ops Manager de varios clústeres:

spec.clusterSpecList

Tipo: colección

Condicional. Detalles de los clústeres miembros de Kubernetes seleccionados en un clúster multi-Kubernetes donde se pretende implementar instancias de Ops Manager o Backup Daemon.Consulte también el ejemplo de la especificación de recursos.

spec.clusterSpecList.clusterName

Tipo: string

Opcional. Nombre del miembro del clúster de Kubernetes en una implementación de MongoDB con varios clústeres de Kubernetes donde el operador de controladores de MongoDB para Kubernetes programa el StatefulSet para Ops Manager o el Backup Daemon.

spec.clusterSpecList.clusterDomain

Tipo: string

Opcional. Se spec.clusterDomain anula para el clúster miembro de Ops Manager específico. Si se omite este valor, se toma como predeterminado el valor establecido spec.clusterDomain en. Kubernetes asigna un FQDN a cada pod. El operador de Kubernetes calcula el FQDN de cada pod utilizando el clusterDomain valor proporcionado. Kubernetes no proporciona una API para consultar estos nombres de host.

spec.clusterSpecList.configuration

Tipo: colección

Opcional. Propiedades de configuración de Ops Manager que anulan las propiedades configuradas en para el spec.configuration clúster específico. Consulte la sección "Ops Manager Configuration Settings" para ver los nombres y descripciones de las propiedades. Cada propiedad toma un valor de string tipo. Por ejemplo, configurar estas propiedades le permite cambiar las variables de entorno que debe pasar a Ops Manager y al Daemon de Backup en ese clúster miembro en particular.

Si omite la especificación de valores, se tomarán como predeterminados los valores establecidos spec.configuration en.

spec.clusterSpecList.jvmParameters

Tipo: arreglo de cadenas

Opcional. Parámetros de JVM pasados ​​a las instancias de OpsManager y Backup Daemon para este clúster miembro.

spec.clusterSpecList.externalConnectivity

Tipo: colección

Opcional. Objeto de configuración que habilita la conectividad externa con Ops Manager para el clúster específico. Esto anula la configuración para spec.externalConnectivity el clúster específico.

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

Si establece este parámetro:

  • El operador de Kubernetes no utiliza valores para este clúster miembro de Ops spec.externalConnectivity Manager.

  • El operador de Kubernetes crea un servicio de Kubernetes,<om-name>-svc-ext llamado, que permite que el tráfico que se origina fuera del clúster de Kubernetes llegue a la aplicación Ops Manager en este clúster miembro.

Si omite este parámetro, el operador de Kubernetes utiliza valores de para este clúster spec.externalConnectivity miembro.

spec.clusterSpecList.statefulSet.spec

Tipo: colección

Opcional. Especificación del StatefulSet que el operador de MongoDB Controllers for Kubernetes crea para un clúster miembro específico en la implementación de Ops Manager con varios clústeres de Kubernetes. Este parámetro anulaspec.statefulSet.spec. Si se omite, el operador de Kubernetes utiliza los valores despec.statefulSet.spec. Por ejemplo, puede usar este parámetro para especificar diferentes valores de almacenamiento para cada uno de los clústeres de Ops Manager en la implementación de MongoDB con varios clústeres de Kubernetes.

Para revisar qué campos puedes agregar spec.clusterSpecList.statefulSet.spec a, consulta las aplicaciones StatefulSetSpec v1 en la documentación de Kubernetes.

spec.clusterSpecList[*].backup

Opcional. Configuraciones de copia de seguridad que anulan los valores especificados en spec.backup para ese clúster miembro en particular.

  • Puedes establecer estos valores solo si está spec.backup.enabled establecido true en.

  • Si omite configurar algún valor para este parámetro, se establecerán de forma predeterminada los valores especificados en la configuración en spec.backup.

  • Esta anulación no admite todas las configuraciones de copia de seguridad. No se pueden anular las siguientes configuraciones de copia de seguridad, ya que se aplican globalmente a todos los clústeres miembros si se especifican en spec.backup:

    • externalServiceEnabled

    • headDB

    • opLogStores

    • blockStores

    • s3Stores

    • fileSystemStores

    • queryableBackupSecretRef

    • encryption

spec.clusterSpecList[*].backup.members

Tipo: entero

Opcional.spec.backup.membersAnulación de. Número de instancias de Backup Daemon que se implementarán en este clúster. Si omite este valor o 0 proporciona, el operador de Kubernetes no implementará instancias de Backup Daemon en un clúster miembro específico.

spec.clusterSpecList[*].backup.assignmentLabels

Tipo: arreglo de cadenas

Opcional. Anulación paraspec.backup.assignmentLabels. Si se especifica, el operador de Kubernetes utiliza los valores especificados en esta anulación para todas las instancias del Daemon de copia de seguridad de un clúster miembro específico. Si omite los valores de este parámetro, los valores predeterminados son los especificados enspec.backup.assignmentLabelspara todas las instancias del Daemon de copia de seguridad de un clúster miembro.

spec.clusterSpecList[*].backup.jvmParameters

Tipo: arreglo de cadenas

Opcional.spec.backup.jvmParametersAnulación para. Permite personalizar el valor de JVM para las instancias del Daemon de copia de seguridad en un clúster miembro 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 ver qué campos se pueden agregar aspec.clusterSpecList[*].backup.statefulSet, consulte las aplicaciones StatefulSetSpec v1 en la documentación de Kubernetes.

Esta sección describe las configuraciones específicas de su implementación de Ops Manager de múltiples clústeres que debe usar para su base de datos de aplicaciones.

spec.applicationDatabase.clusterSpecList

Tipo: colección

Detalles de clústeres miembros de Kubernetes seleccionados en una implementación de MongoDB de múltiples clústeres de Kubernetes que sirven como nodos que alojan la base de datos de la aplicación.

spec.applicationDatabase.clusterSpecList.clusterName

Tipo: string

Nombre del miembro del clúster de Kubernetes en una implementación de MongoDB de varios clústeres de Kubernetes donde el operador de controladores MongoDB para Kubernetes programa el StatefulSet para la base de datos de la aplicación.

Importante

No se puede convertir una única instancia de Ops Manager en un clúster de múltiples Kubernetes en una instancia de implementación de MongoDB modificando topology las clusterSpecList configuraciones y en el CRD.

spec.applicationDatabase.clusterSpecList.members

Tipo: número

Número de nodos statefulSet en el clúster miembro dado. El clúster miembro es uno de los clústeres que aloja la base de datos de la aplicación en una implementación de MongoDB con varios 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 predeterminado es SingleCluster.

  • Si especifica MultiCluster, debe especificar al menos un miembro

  • clúster en el que deseas implementar la base de datos de la aplicación utilizando los parámetros clusterSpecList, clusterName, members.

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

Para obtener más información, consulte el ejemplo de la especificación de recursos de múltiples clústeres.

Esta sección describe configuraciones específicas para su implementación de Ops Manager de múltiples clústeres que puede usar para su base de datos de aplicaciones.

spec.applicationDatabase.clusterSpecList.externalAccess

Tipo: string

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

De forma predeterminada, cada miembro del conjunto de réplicas usa el FQDN del pod de Kubernetes*.svc.cluster.local () como nombre de host predeterminado. Sin embargo, si se agrega un dominio externo a esta configuración, el conjunto de réplicas usa un nombre de host que es un subdominio del dominio especificado. Este nombre de host tiene el siguiente formato:

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

Por ejemplo:

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

Importante

Utilice esta configuración solo al implementar una base de datos de aplicaciones sin una malla de servicios.Consulte Multi-Cluster Ops Manager sin una malla de servicios.

spec.applicationDatabase.clusterSpecList.memberConfig

Tipo: arreglo de cadenas

Especificación para cada miembro del conjunto de réplicas de la base de datos de aplicaciones en su implementación de Ops Manager de varios clústeres.

Importante

Si spec.topology SingleClusterestablece en, utilice spec.applicationDatabase.memberConfig spec.applicationDatabase.clusterSpecList.memberConfig enlugar de.

El número de elementos en la memberConfig lista debe ser igual spec.applicationDatabase.clusterSpecList.members a.

El orden de los elementos en la lista memberConfig debe reflejar el orden de los miembros en el conjunto de réplicas. Por ejemplo, el primer elemento de la matriz afecta al pod en el índice 0, el segundo elemento afecta al índice 1, y así sucesivamente.

Ejemplo

Considere la siguiente especificación de ejemplo para un conjunto de réplicas de tres miembros 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 aplicaciones se convierta en el principal.

  • Para aumentar la probabilidad relativa de que un miembro del conjunto de réplicas se convierta en el principal, especifique un valor priority más alto.

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

Por ejemplo, un miembro con un memberConfig.priority de 1.5 tiene más probabilidades de convertirse en el principal que un miembro con un memberConfig.priority de 0.5.

Un miembro con un memberConfig.priority de 0 no puede ser el miembro principal. Para obtener más información, consulte Prioridad de miembros.

spec.applicationDatabase.clusterSpecList.memberConfig.tags

Tipo: mapa

Mapa de etiquetas de conjuntos de réplicas para dirigir operaciones de lectura y escritura a miembros específicos de su conjunto de réplicas de la base de datos de aplicaciones.

spec.applicationDatabase.clusterSpecList.memberConfig.votes

Tipo: número

Determina si un miembro del conjunto de réplicas de la base de datos de la aplicación puede votar en una elección. Se establece en 1 para permitir que el miembro vote. Se establece en 0 para excluir al miembro de una elección.

Volver

Referencia