Especificación de recursos de base de datos de MongoDB

Requerido

apiVersion

Tipo: string

Versión del esquema de recursos MongoDB.

kind

Tipo: string

Tipo de recurso MongoDB a crear. Establézcalo en MongoDB.

metadata.name

Tipo: string

Nombre del recurso MongoDB que creas.

Los nombres de recursos deben tener 44 caracteres o menos.

spec.credentials

Tipo: string

Obligatorio. Nombre del secreto de Kubernetes secreto que se creó como Ops Manager API credenciales de autenticación para que el Operador de Kubernetes se comunique con Cloud Manager u Ops Manager.

El objeto secreto de Kubernetes de Ops Manager que contiene las credenciales debe existir en el mismo espacio de nombres que el recurso que desea crear.

Importante

El operador gestiona los cambios en el secreto.

El operador de Kubernetes rastrea cualquier cambio en el Secreto y reconcilia el estado del recurso MongoDB.

spec.persistent

Tipo: booleano

Por defecto: true

ADVERTENCIA: Otorgue a sus contenedores permiso para escribir en su volumen persistente. El operador de Kubernetes fsGroup = 2000 establece, runAsUser = 2000 y runAsNonRoot = true en. El securityContext operador de Kubernetes establece fsgroup igual a runAsUser para que el volumen pueda ser escrito por un usuario que ejecuta el proceso principal en el contenedor. Para obtener más información,consulte "Configurar un contexto de seguridad para un pod o contenedor" y la información relacionada en la documentación de Kubernetes. Si volver a implementar el recurso no soluciona los problemas con su volumen persistente, póngase en contacto con el soporte técnico de MongoDB.

Si no usas volúmenes persistentes, el Disk Usage y Disk IOPS gráficas no pueden mostrarse ni en la pestaña Processes de la página Deployment ni en la página Metrics al revisar los datos de esta implementación.

spec.type

Tipo: string

Tipo de recurso MongoDB a crear. Los valores aceptados son:

• Standalone

• ReplicaSet

• ShardedCluster

spec.version

Tipo: string

Versión de MongoDB que instalaste en este recurso MongoDB.

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

Nota

Si actualiza este valor a una versión posterior de MongoDB para sus recursos de base de datos, 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 spec.featureCompatibilityVersion con la nueva versión o AlwaysMatchVersion con. Para obtener más información,spec.featureCompatibilityVersion consulte.

Condicional

Cada recurso debe utilizar una de las siguientes configuraciones:

spec.opsManager.configMapRef.name

Tipo: string

Nombre del ConfigMap con la configuración de conexión de Cloud Manager u Ops Manager. El parámetro es un alias para esta spec.cloudManager.configMapRef.name configuración y puede usarse en su lugar.

Este valor debe existir en el mismo espacio de nombres que el recurso que quieres crear.

Importante

El operador administra los cambios en ConfigMap

El operador de Kubernetes rastrea cualquier cambio en ConfigMap y concilia el estado del recurso MongoDB.

spec.cloudManager.configMapRef.name

Tipo: string

Alias spec.opsManager.configMapRef.name ​​para.

Opcional

Cada tipo de recurso puede usar la(s) siguiente(s) configuración(es):

metadata.annotations.mongodb.com/v1.architecture

Tipo: string

Determina la arquitectura de contenedor utilizada por una implementación específica:

• Los contenedores no estáticos por defecto que descargan el binario de MongoDB en tiempo de ejecución, o

• Contenedores estáticos (Visualización pública) que son inmutables en tiempo de ejecución.

Los valores aceptados son:

• static

• non-static

apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: my-project
  annotations:
    mongodb.com/v1.architecture: "static"

spec.agent.backupAgent.logRotate

Tipo: objeto

Umbrales a partir de los cuales el MongoDB Agent rota el registro de copia de seguridad.

spec.agent.backupAgent.logRotate.sizeThresholdMB

Tipo: entero

Tamaño máximo, en MB, de una entrada de registro de copia de seguridad antes de que el MongoDB Agent rote los registros.

spec.agent.backupAgent.logRotate.timeThresholdHrs

Tipo: entero

Número de horas después de las cuales el Agente MongoDB rota el archivo de registro de respaldo.

spec.agent.mongod.auditlogRotate

Tipo: objeto

Objeto que contiene la configuración de rotación del registro de auditoría para los procesos de MongoDB.

spec.agent.mongod.auditlogRotate.sizeThresholdMB

Tipo: número

Tamaño máximo, en MB, de un archivo de registro de auditoría antes de que el MongoDB Agent gire los registros.

spec.agent.mongod.auditlogRotate.timeThresholdHrs

Tipo: entero

Número de horas después de las cuales el Agente MongoDB rota el archivo de registro de auditoría.

spec.agent.mongod.auditlogRotate.numUncompressed

Tipo: entero

Número máximo de entradas de registro totales de auditoría que se pueden dejar sin comprimir, incluyendo la entrada de registro actual.

spec.agent.mongod.auditlogRotate.numTotal

Tipo: entero

Número total de archivos de registro de auditoría que Ops Manager conserva. Si no se establece este valor, el número total de archivos de registro de auditoría predeterminado 0 es.

spec.agent.mongod.auditlogRotate.percentOfDiskspace

Tipo: número

Porcentaje máximo del espacio total en disco que Ops Manager puede utilizar para almacenar las entradas de registro expresado como decimal. Si se supera este límite, Ops Manager borra las entradas de registro comprimidas hasta cumplirlo. Ops Manager elimina primero los archivos de registro más antiguos.

El valor por defecto es 0,02.

spec.agent.mongod.logRotate

Tipo: objeto

Umbrales después de los cuales Ops Manager rota los registros de MongoDB de un proceso.

spec.agent.mongod.logRotate.sizeThresholdMB

Tipo: entero

Tamaño máximo en MB para una entrada de registro individual antes de que Ops Manager lo rote. Ops Manager rota la entrada de registro inmediatamente si cumple con el valor dado en este sizeThresholdMB o en el spec.agent.mongod.logRotate.timeThresholdHrs.

spec.agent.mongod.logRotate.timeThresholdHrs

Tipo: entero

Duración máxima en horas de 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 una vez que el archivo cumple timeThresholdHrs con spec.agent.mongod.logRotate.sizeThresholdMB o.

spec.agent.monitoringAgent.logRotate

Tipo: objeto

Umbrales después de los cuales el MongoDB Agent rota el registro de supervisión.

spec.agent.monitoringAgent.logRotate.sizeThresholdMB

Tipo: entero

Tamaño máximo en MB para un archivo de registro individual antes de que el Agente MongoDB rote el registro de monitoreo.

spec.agent.monitoringAgent.logRotate.timeThresholdHrs

Tipo: entero

Número de horas después de las cuales el Agente de MongoDB rota el registro de supervisión.

spec.agent.readinessProbe.environmentVariables

Tipo: objeto

Configura las siguientes variables de entorno que se utilizan para controlar los archivos de registro de la sonda de preparación:

• READINESS_PROBE_LOGGER_BACKUPS

• REGISTRADOR DE COMPROBACIÓN DE PREPARACIÓN COMPRIMIR

• READINESS_PROBE_LOGGER_MAX_SIZE

• READINESS_PROBE_LOGGER_MAX_AGE

• MDB_WITH_AGENT_FILE_LOGGING

• LOG_FILE_PATH

apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: my-project
spec:
  agent:
    readinessProbe:
      environmentVariables:
        READINESS_PROBE_LOGGER_BACKUPS: 1
        READINESS_PROBE_LOGGER_MAX_SIZE: 10
        READINESS_PROBE_LOGGER_MAX_AGE: 3
        READINESS_PROBE_LOGGER_COMPRESS: true
        MDB_WITH_AGENT_FILE_LOGGING: false
        LOG_FILE_PATH: /var/log/mongodb-mms-automation/readiness.log

spec.featureCompatibilityVersion

Tipo: string

Por defecto, la versión principal anterior de MongoDB tras la actualización de MongoDB.

Limita los cambios en los datos que ocurren con una nueva actualización a una nueva versión principal. Por ejemplo, si actualizas de MongoDB 5.0 a MongoDB 6.0, la compatibilidad de características entre versiones se mantiene en 5.0 para que tengas la opción de realizar un downgrade si es necesario.

Si quieres que la compatibilidad de características entre versiones coincida con la nueva versión de MongoDB, debes configurar manualmente featureCompatibilityVersion a la nueva versión. Por ejemplo, featureCompatibilityVersion: 6.0.

Como alternativa, puede habilitar la opción AlwaysMatchVersion para actualizar automáticamente la versión de compatibilidad de funciones para que coincida con la versión de MongoDB durante las actualizaciones. Por ejemplo, featureCompatibilityVersion: AlwaysMatchVersion.

Para aprender más sobre la compatibilidad de funcionalidades, consulta setFeatureCompatibilityVersion en el Manual de MongoDB.

spec.clusterDomain

Tipo: string

por defecto: clúster.local

Nombre de dominio del clúster de Kubernetes donde se implementa el Operador de Kubernetes. Cuando Kubernetes crea un StatefulSet, Kubernetes asigna a cada Pod un FQDN. Para actualizar Cloud Manager u Ops Manager, el Operador de Kubernetes calcula el FQDN para cada pod usando un nombre de clúster proporcionado. Kubernetes no proporciona una API para query estos nombres de host.

Advertencia

Debes configurar spec.clusterDomain si tu clúster de Kubernetes tiene un dominio por defecto distinto del por defecto cluster.local. Si no utilizas la opción por defecto ni configuras la opción spec.clusterDomain, el operador de Kubernetes podría no funcionar como se espera.

spec.clusterName

Tipo: string

por defecto: clúster.local

Importante

spec.clusterName está obsoleto

Use spec.clusterDomain en su lugar.

Nombre de dominio del clúster de Kubernetes donde se implementa el Operador de Kubernetes. Cuando Kubernetes crea un StatefulSet, Kubernetes asigna a cada Pod un FQDN. Para actualizar Cloud Manager u Ops Manager, el Operador de Kubernetes calcula el FQDN para cada pod usando un nombre de clúster proporcionado. Kubernetes no proporciona una API para query estos nombres de host.

Advertencia

Debes configurar spec.clusterDomain si tu clúster de Kubernetes tiene un dominio por defecto distinto del por defecto cluster.local. Si no utilizas la opción por defecto ni configuras la opción spec.clusterDomain, el operador de Kubernetes podría no funcionar como se espera.

metadata.namespace

Tipo: string

Kubernetes namespace (espacio de nombres), donde se crea este recurso de MongoDB y otros objetos.

spec.service

Tipo: string

Por defecto: <resource_name>+"-svc" y <resource_name>+"-svc-external".

Importante

spec.service está Deprecated

Use spec.statefulSet.spec.serviceName en su lugar.

Nombre del servicio de Kubernetes que se creará o usará para un StatefulSet. Si el servicio con este nombre ya existe, el operador de Controladores de MongoDB para Kubernetes no lo elimina ni lo vuelve a crear. Esta configuración le permite crear sus propios servicios personalizados y que el operador de Kubernetes los reutilice.

spec.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.security.authentication.ignoreUnknownUsers

Tipo: booleano

Por defecto: false

Determina si se pueden modificar los usuarios de la base de datos que no fueron configurados a través de Kubernetes operador, Cloud Manager u Ops Manager.

Para administrar usuarios de la base de datos directamente a través de o, configure esta mongod mongosconfiguración true en.

Configuración autónoma

spec.additionalMongodConfig

tipo: colección

Opciones de configuración adicionales con las que desea iniciar procesos de MongoDB.

El operador de Kubernetes admite todas las opciones de configuración que admite la versión de MongoDB que implementa a través del agente de MongoDB, excepto que el operador de Kubernetes anula los valores que proporciona para cualquiera de las siguientes opciones:

• net.port

• net.tls.certificateKeyFile

• net.tls.clusterFile

• replication.replSetName

• security.clusterAuthMode

• sharding.clusterRole

• storage.dbPath

• systemLog.destination

• systemLog.path

Para obtener más información sobre las opciones de configuración que posee el operador de Kubernetes, consulte Configuración exclusiva del operador de Kubernetes de MongoDB.

Para saber qué opciones de configuración puedes utilizar, consulta Opciones avanzadas para implementaciones de MongoDB en la documentación de Ops Manager.

spec.agent

tipo: colección

Configuración del MongoDB Agent para el recurso de base de datos MongoDB.

spec.agent.startupOptions

tipo: colección

Configuración del agente MongoDB con el que desea iniciar el recurso de base de datos MongoDB.

Debe proporcionar la configuración de MongoDB Agent como pares clave-valor. Los valores deben ser cadenas.

Para obtener una lista de la configuración admitida de MongoDB Agent, consulta:

• Configuración del agente MongoDB para proyectos de Cloud Manager.

• Configuración del MongoDB Agent para la versión de Ops Manager que implementaste con el operador de Kubernetes.

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: my-standalone
6
spec:
7
  version: "8.0.0"
8
  service: my-service
9
10
  opsManager:
11
    configMapRef:
12
      name: my-project
13
  credentials: my-credentials
14
  type: Standalone
15
16
  persistent: true
17
  agent:
18
    startupOptions:
19
      maxLogFiles: "30"
20
      dialTimeoutSeconds: "40"
21
...

spec.podSpec

Tipo: objeto

Objeto que contiene las especificaciones de los Pods de CustomResourceDefinition de MongoDB.

spec.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 añades spec.externalAccess, el Operador de Kubernetes crea un servicio externo para cada Pod en un set de réplicas. Los servicios externos proporcionan un punto de entrada externo para cada pod de la base de datos MongoDB en un clúster. Cada servicio externo tiene selectores que emparejan el servicio externo con 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 por defecto:

Campo	Valor	Descripción
Name	<pod-name>-svc-external	Nombre del Servicio externo. No puedes cambiar este valor.
Type	LoadBalancer	Crea un servicio externo LoadBalancer.
Port	<Port Number>	Un puerto para mongod.
publishNotReadyAddress	true	Especifica que registros DNS se crean incluso si el Pod no está listo. No configures false para ningún Pod de base de datos.

Nota

Si estableces spec.externalAccess.externalDomain, el servicio externo añade otro puerto (Port Number + 1) para copias de seguridad.

spec.externalAccess.externalService

tipo: colección

Especificación para sobrescribir los valores por defecto en spec.externalAccess.

Cuando estableces la configuración de spec.externalAccess, el Operador de Kubernetes crea automáticamente un servicio de balanceador de carga externo con valores por defecto. Puedes anular ciertos valores o agregar nuevos valores según tus necesidades. Por ejemplo, si se pretende crear servicios NodePort y no se necesita un balanceador de carga, se deben configurar sobreescrituras en la 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, consulta ServiceSpec en la documentación de Kubernetes.

spec.externalAccess.externalService.annotations

tipo: colección

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

Puedes usar anotaciones para especificar los valores de marcador de posición para los servicios externos utilizados por los implementaciones de Kubernetes operador. El operador de Kubernetes sustituye automáticamente estos valores por los valores correctos, tal como se describe en la siguiente tabla. Utilizar marcadores de posición permite proporcionar anotaciones específicas en cada servicio para un Pod específico.

Valor	Descripción
{resourceName}	Igual metadata.name a.
{namespace}	Igual metadata.namespace a.
{podIndex}	Índice del Pod asignado por el StatefulSet y dirigido por el servicio externo actual.
{podName}	Igual a {resourceName}-{podIndex}.
{statefulSetName}	El StatefulSet. Igual a {resourceName}.
{externalServiceName}	Nombre generado del servicio externo, basado en los valores de los marcadores de posición que hayas especificado. 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 tu implementación. Si has configurado tu implementación para utilizar external domains, el nombre de host del proceso utiliza el siguiente formato: {resourceName}-{podIndex}.{mongodProcessDomain} Por ejemplo: mdb-rs-1.example.com Si tu 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 para el ServiceSpec. Para obtener más información, consulta spec.externalAccess.externalService.

spec.podSpec.persistence.single

tipo: colección

Haga que el Operador de Kubernetes cree un Reclamo de Volumen Persistente y monte los tres directorios de datos, diario y registros en un mismo Volumen Persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puedes definir esta colección o bien las persistence.multiple colecciones pero no ambas.

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 por defecto es 16 Gi. Por ejemplo, si una implementación autónoma 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úrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.

spec.podSpec.persistence.multiple.data

tipo: colección

Hace que el operador de Kubernetes cree un reclamo de volumen persistente y monte un directorio para datos en su propio volumen persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puede establecer esta colección o la colección persistence.single, pero no ambas.

Escalar	Tipo de dato	Descripción
labelSelector	string	Etiqueta utilizada para vincular volúmenes montados a directorios.
storage	string	Capacidad mínima de almacenamiento que debe estar disponible en un nodo de Kubernetes para alojar una implementación independiente en Kubernetes. Este valor se expresa como un entero seguido de una unidad de almacenamiento en notación JEDEC. El valor por defecto es 16 Gi. Por ejemplo, si este recurso MongoDB requiere 60 gigabytes de espacio de almacenamiento, establezca este valor en 60Gi.
storageClass	string	Tipo de almacenamiento necesario para la implementación independiente. Puede crear este tipo de almacenamiento como un objeto StorageClass antes de usarlo en esta especificación de objeto. Asegúrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.

spec.podSpec.persistence.multiple.journal

tipo: colección

Permite que Kubernetes Operator cree un Reclamación de volumen persistente y monte un directorio para el diario en su propio Volumen persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puede establecer esta colección o la colección persistence.single, pero no ambas.

Escalar	Tipo de dato	Descripción
labelSelector	string	Etiqueta utilizada para vincular volúmenes montados a directorios.
storage	string	Capacidad mínima de almacenamiento que debe estar disponible en un nodo de Kubernetes para alojar una implementación independiente en Kubernetes. Este valor se expresa como un entero seguido de una unidad de almacenamiento en notación JEDEC. El valor por defecto es 1Gi. Por ejemplo, si este recurso MongoDB requiere 60 gigabytes de espacio de almacenamiento, establezca este valor en 60Gi.
storageClass	string	Tipo de almacenamiento necesario para la implementación independiente. Puede crear este tipo de almacenamiento como un objeto StorageClass antes de usarlo en esta especificación de objeto. Asegúrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.

spec.podSpec.persistence.multiple.logs

tipo: colección

Hace que el operador de Kubernetes cree un Reclamo de volumen persistente y monte un directorio para los registros en su propio Volumen Persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puede establecer esta colección o la colección persistence.single, pero no ambas.

Escalar	Tipo de dato	Descripción
labelSelector	string	Etiqueta utilizada para vincular volúmenes montados a directorios.
storage	string	Capacidad mínima de almacenamiento que debe estar disponible en un nodo de Kubernetes para alojar una implementación independiente en Kubernetes. Este valor se expresa como un entero seguido de una unidad de almacenamiento en notación JEDEC. El valor por defecto es 3Gi. Por ejemplo, si este recurso MongoDB requiere 60 gigabytes de espacio de almacenamiento, establezca este valor en 60Gi.
storageClass	string	Tipo de almacenamiento necesario para la implementación independiente. Puede crear este tipo de almacenamiento como un objeto StorageClass antes de usarlo en esta especificación de objeto. Asegúrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.

spec.podSpec.podTemplate

tipo: colección

Plantilla para los pods de Kubernetes que el operador de controladores MongoDB para Kubernetes crea para los recursos de base de datos de MongoDB.

Los valores de la plantilla tienen prioridad sobre los valores especificados en spec.podSpec.

Nota

El Operador de Kubernetes no valida los campos que se proporcionan en spec.podSpec.podTemplate.

spec.podSpec.podTemplate.metadata

tipo: colección

Metadatos para los Pods de Kubernetes que los Controladores de MongoDB para el Operador de Kubernetes crean para los recursos de la base de datos MongoDB.

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

spec.podSpec.podTemplate.spec

tipo: colección

Especificaciones de los Pods de Kubernetes que los Controladores de MongoDB del Operador de Kubernetes crean para recursos de bases de datos MongoDB.

Para revisar los campos que puedes añadir a spec.podSpec.podTemplate.spec, consulta la Kubernetes PodSpec v1 Core API.

Nota

Cuando añades contenedores a spec.podSpec.podTemplate.spec.containers, el operador de Kubernetes los añade al pod de Kubernetes. Estos contenedores se añaden a los contenedores de recursos de bases de datos de MongoDB en el pod.

Utiliza esta configuración para especificar la asignación de CPU y RAM para cada pod. Para obtener ejemplos, consulta las muestras en GitHub.

spec.podSpec.podTemplate.spec.affinity.nodeAffinity

Tipo: Estructura

Regla de Kubernetes para colocar pods para el conjunto de réplicas en un rango específico de nodos.

Para un rendimiento de lectura-escritura optimizado, utiliza reglas de afinidad de nodos que restrinjan los Pods para ejecutarse en nodos en particular, o para dar preferencia a la ejecución en nodos en particular.

spec.podSpec.podTemplate.spec.affinity.podAffinity

Tipo: Estructura

Regla de Kubernetes para determinar si varios recursos MongoDB Pods deben estar ubicados junto con otros Pods. Para obtener más información sobre los casos de uso, consulta afinidad y anti-afinidad en la documentación de Kubernetes.

spec.podSpec.podTemplate.spec.affinity.podAntiAffinity

Tipo: Estructura

Default: kubernetes.io/hostname

Establece una regla para distribuir Pods que alojan el recurso MongoDB en diferentes ubicaciones. Una ubicación puede ser un solo nodo, rack o región. De forma predeterminada, el operador de Kubernetes intenta distribuir los pods entre diferentes nodos.

spec.podSpec.podTemplate.spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey

Tipo: Estructura

Default: kubernetes.io/hostname

Esta clave define qué etiqueta se usa para determinar a qué dominio de la topología pertenece un nodo.

Configuración del conjunto de réplicas

Las siguientes configuraciones se aplican a los tipos de recursos del conjunto de réplicas:

spec.backup

tipo: colección

El contenedor de colección para spec.backup.mode, que habilita copias de seguridad continuas para los recursos de MongoDB en Kubernetes Operator.

spec.backup.assignmentLabels

Tipo: arreglo

Una lista de etiquetas separadas por comas que se asignan a los daemons de copias de seguridad, almacenes oplog, blockstores, almacén de snapshots de S3 y almacenes del sistema de archivos a Proyectos o grupos específicos. Utiliza etiquetas de asignación para identificar que almacenes de copia de seguridad específicos están asociados a proyectos concretos.

Si se establecen etiquetas de asignación mediante el operador de Kubernetes, los valores que se establecen en el archivo de configuración de Kubernetes para las etiquetas de asignación sobrescriben los valores definidos en la interfaz de usuario del Ops Manager. Las etiquetas de asignación que no configuraste usando el Operador de Kubernetes continúan usando los valores configurados en la Interfaz de usuario de Ops Manager.

Nota

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

spec.backup.mode

Tipo: string

Permite realizar copias de seguridad continuas de un recurso de MongoDB. Los valores posibles son enabled, disabled y terminated.

Nota

La configuración spec.backup.mode depende de la Copia de seguridad habilitada en el Ops Manager y requiere que el valor spec.backup.enabled en la especificación de recursos del Ops Manager esté configurado en true.

Después de habilitar las copias de seguridad continuas para su recurso MongoDB con spec.backup.mode, puede verificar el estado de la copia de seguridad.

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 copia de seguridad de KMIP. Para obtener más información, consulta Configuración del cifrado de copia de seguridad KMIP para Ops Manager.

spec.backup.encryption.kmip.client

Tipo: objeto

Objeto que contiene los ajustes de configuración del cliente de cifrado de copia de seguridad KMIP.

spec.backup.encryption.kmip.client.clientCertificatePrefix

Tipo: string

spec.backup.snapshotSchedule

tipo: colección

Contenedor de colección para la configuración del cronograma de snapshot de copia de seguridad continuas para recursos de MongoDB en Kubernetes operador.

spec.backup.snapshotSchedule.snapshotIntervalHours

Tipo: número

Número de horas entre instantáneas. Puede establecer un valor de 6, 8, 12 o 24.

spec.backup.snapshotSchedule.snapshotRetentionDays

Tipo: número

Número de días para mantener las snapshot recientes. Puedes establecer un valor entre 2 y 5, inclusive.

spec.backup.snapshotSchedule.dailySnapshotRetentionDays

Tipo: número

Número de días para conservar las instantáneas diarias. Puede establecer un valor entre 1 y 365, inclusivo. Establecer el valor en 0 desactiva esta regla.

spec.backup.snapshotSchedule.weeklySnapshotRetentionWeeks

Tipo: número

Número de semanas para conservar los snapshots semanales. Puedes establecer un valor entre 1 y 52, inclusive. Configurar el valor a 0 deshabilita esta regla.

spec.backup.snapshotSchedule.monthlySnapshotRetentionMonths

Tipo: número

Número de meses para conservar copias de seguridad mensuales. Puede establecer un valor entre 1 y 36, inclusivo. Establecer el valor en 0 desactiva esta regla.

spec.backup.snapshotSchedule.pointInTimeWindowHours

Tipo: número

Número de horas en el pasado para las que puedes crear una snapshot puntual.

spec.backup.snapshotSchedule.referenceHourOfDay

Tipo: número

HoraUTC del día para programar instantáneas con formato de 24 horas. Puede establecer un valor entre 0 y,23 ambos inclusive.

spec.backup.snapshotSchedule.referenceMinuteOfHour

Tipo: número

UTC minuto de la hora para programar snapshot. Puede establecer un valor entre 0 y 59, ambos inclusive.

spec.backup.snapshotSchedule.fullIncrementalDayOfWeek

Tipo: string

Día de la semana en que Ops Manager toma una snapshot completa. Esta configuración garantiza una copia de seguridad completa reciente. Ops Manager establece el valor por defecto en SUNDAY.

spec.clusterName

Tipo: string

por defecto: clúster.local

Importante

spec.clusterName está obsoleto

Use spec.clusterDomain en su lugar.

Nombre de dominio del clúster de Kubernetes donde se implementa el Operador de Kubernetes. Cuando Kubernetes crea un StatefulSet, Kubernetes asigna a cada Pod un FQDN. Para actualizar Cloud Manager u Ops Manager, el Operador de Kubernetes calcula el FQDN para cada pod usando un nombre de clúster proporcionado. Kubernetes no proporciona una API para query estos nombres de host.

Advertencia

Debes configurar spec.clusterDomain si tu clúster de Kubernetes tiene un dominio por defecto distinto del por defecto cluster.local. Si no utilizas la opción por defecto ni configuras la opción spec.clusterDomain, el operador de Kubernetes podría no funcionar como se espera.

spec.connectivity.replicaSetHorizons

tipo: colección

Te permite proporcionar distintas configuraciones DNS para aplicaciones clientes y los Agentes de MongoDB. El operador de Kubernetes utiliza DNS de horizonte dividido para los miembros de los conjuntos de réplicas. Esta funcionalidad permite la comunicación tanto dentro del clúster de Kubernetes como desde fuera de Kubernetes.

Puede agregar múltiples asignaciones externas por host.

Requisitos de Split Horizon:

• Asegúrese de que cada valor en este arreglo sea único.

• Asegúrate de que el número de entradas en este arreglo coincida con el valor dado en spec.members.

• Proporcione un valor para la configuración spec.security.certsSecretPrefix para habilitar TLS. Este método para usar horizontes divididos requiere la extensión de Indicación de nombre de servidor del protocolo TLS.

• Configurar el enrutamiento para nombres de host externos.

Ejemplo

En este ejemplo, los miembros del conjunto de réplicas se comunican entre sí en el horizonte example-localhost. Los clientes se comunican con el conjunto de réplicas mediante el horizonte example-website.

Los nombres de los horizontes mencionados son arbitrarios para los propósitos de este ejemplo. Puedes poner el nombre que quieras a tu horizonte, pero asegúrate de que el nombre del horizonte sea el mismo para todos los hostnames que forman parte de ese horizonte.

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: <my-replica-set>
6
spec:
7
  members: 3
8
  version: "8.0.0"
9
  type: ReplicaSet
10
  opsManager:
11
    configMapRef:
12
      name: <configMap.metadata.name>
13
  credentials: <mycredentials>
14
  persistent: true

15
  security:
16
    tls:
17
      enabled: true
18
  connectivity:
19
    replicaSetHorizons:
20
      - "example-website": "web1.example.com:30907"
21
      - "example-website": "web2.example.com:32350"
22
      - "example-website": "web3.example.com:31185"
23
...

spec.externalAccess.externalDomain

Tipo: string

Un dominio externo utilizado para exponer externamente su implementación de set 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>-<pod-idx>.<externalDomain>

Por ejemplo:

replica-set-1.example.com

Después de implementar el set de réplicas con esta configuración, el Operador de Kubernetes utiliza el nombre de host con el dominio externo para anular el campo processes[n].hostname en el configuración de automatización de Ops Manager. Luego, el agente de MongoDB utiliza este nombre de host para conectarse a mongod.

Para especificar otros nombres de host para conectarse al set de réplicas, se puede utilizar la configuración de spec.connectivity.replicaSetHorizons. Sin embargo, las siguientes conexiones aún usan el nombre de host con el dominio externo:

• El agente de MongoDB se conecta a mongod.

• mongod para conectar con otras mongod instancias.

ADVERTENCIA: Especificar este campo cambia la forma en que Ops Manager registra los procesos mongod. No puedes cambiar el valor de este campo ni de ninguno de los campos processes[n].hostname en la configuración de automatización de Ops Manager para una implementación activa de un set de réplicas.

spec.members

Tipo: entero

Obligatorio. Número de miembros del conjunto de réplicas.

spec.memberConfig

tipo: colección

Especificación para cada miembro del set de réplicas de MongoDB implementado a partir del recurso MongoDB.

El orden de los elementos en el arreglo debe reflejar el orden de los miembros 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

Considere la siguiente especificación de ejemplo para un conjunto de réplicas de tres nodos:

spec:
  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.5"
      tags:
        tag2: "value2"
        environment: "prod"

spec.memberConfig.priority

Tipo: string

Número que indica la probabilidad relativa de que un set de réplicas de MongoDB se convierta en el 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 conjunto de réplicas se convierta en el principal, especifique 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.memberConfig.tags

Tipo: mapa

Mapa de etiquetas de set de réplicas para dirigir las operaciones de lectura y escritura a nodos específicos de su set de réplicas de MongoDB.

spec.memberConfig.votes

Tipo: número

Determina si un miembro de un conjunto de réplicas de MongoDB puede votar en una elección. Configura en 1 para permitir que el nodo vote. Configura en 0 para excluir al nodo de una elección.

La configuración siguiente se aplica únicamente a los tipos de recursos de sets de réplicas:

spec.backup.autoTerminateOnDeletion

Tipo: booleano

Bandera que controla si el Operador de Kubernetes se detiene y finaliza la copia de seguridad cuando elimina un recurso de MongoDB. Si se omite, el valor por defecto es false. Activar este indicador en true es útil cuando se desea borrar el recurso personalizado de MongoDB mientras la spec.backup.mode configuración está establecida en enabled.

Configuración de clúster fragmentado

Las siguientes configuraciones se aplican únicamente a los tipos de recursos de clúster fragmentados:

spec.backup.snapshotSchedule.clusterCheckpointIntervalMin

Tipo: número

Número de minutos entre los puntos de control sucesivos del clúster. Esta configuración solo se aplica a los clústeres fragmentados que ejecutan MongoDB con una versión de compatibilidad de características entre versiones 4.0 o anterior. Este número determina el nivel de detalle de las restauraciones a un punto específico del tiempo para los clústeres. Puede establecer un valor de 15, 30 o 60.

spec.configServerCount

Tipo: entero

Obligatorio. Número de nodos en el servidor de configuración.

spec.configSrv.additionalMongodConfig

tipo: colección

Opciones de configuración adicionales con las que se desee iniciar cada nodo del servidor de configuración.

El operador de Kubernetes admite todas las opciones de configuración que admite la versión de MongoDB que implementa a través del agente de MongoDB, excepto que el operador de Kubernetes anula los valores que proporciona para cualquiera de las siguientes opciones:

• net.tls.certificateKeyFile

• net.tls.clusterFile

• replication.replSetName

• security.clusterAuthMode

• sharding.clusterRole

• storage.dbPath

• systemLog.destination

• systemLog.path

Para obtener más información sobre las opciones de configuración que posee el operador de Kubernetes, consulte Configuración exclusiva del operador de Kubernetes de MongoDB.

Para saber qué opciones de configuración puedes utilizar, consulta Opciones avanzadas para implementaciones de MongoDB en la documentación de Ops Manager.

spec.configSrv.agent

tipo: colección

Configuración del MongoDB Agent para cada nodo del servidor de configuración.

spec.configSrv.agent.startupOptions

tipo: colección

MongoDB Agent settings con la que desea iniciar cada nodo de servidor de configuración.

Debe proporcionar la configuración de MongoDB Agent como pares clave-valor. Los valores deben ser cadenas.

Para obtener una lista de la configuración admitida de MongoDB Agent, consulta:

• Configuración del agente MongoDB para proyectos de Cloud Manager.

• Configuración del MongoDB Agent para la versión de Ops Manager que implementaste con el operador de Kubernetes.

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: my-sharded-cluster-options
6
spec:
7
  version: "8.0.0"
8
  type: ShardedCluster
9
  opsManager:
10
    configMapRef:
11
      name: my-project
12
  credentials: my-credentials
13
  persistent: true
14
  shardCount: 2
15
  mongodsPerShardCount: 3
16
  mongosCount: 2
17
  configServerCount: 1
18
19
  mongos:
20
    agent:
21
      startupOptions:
22
        maxLogFiles: "30"
23
24
  configSrv:
25
     agent:
26
       startupOptions:
27
         dialTimeoutSeconds: "40"
28
  shard:
29
     agent:
30
       startupOptions:
31
         serverSelectionTimeoutSeconds: "20"
32
...

spec.configSrvPodSpec

Tipo: objeto

El objeto que contiene las especificaciones para los Pods del servidor de configuración de MongoDB CustomResourceDefinition.

spec.configSrvPodSpec.persistence.single

tipo: colección

Haga que el Operador de Kubernetes cree un Reclamo de Volumen Persistente y monte los tres directorios de datos, diario y registros en un mismo Volumen Persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puedes definir esta colección o bien las persistence.multiple colecciones pero no ambas.

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 por defecto es 5 Gi. Por ejemplo, si cada nodo de servidor de configuración necesita 60 gigabytes de espacio de almacenamiento, configure 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úrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.

spec.configSrvPodSpec.persistence.multiple.data

tipo: colección

Hace que el operador de Kubernetes cree un reclamo de volumen persistente y monte un directorio para datos en su propio volumen persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puede establecer esta colección o la colección persistence.single, pero no ambas.

Escalar	Tipo de dato	Descripción
labelSelector	string	Etiqueta utilizada para vincular volúmenes montados a directorios.
storage	string	Capacidad mínima de almacenamiento que debe estar disponible en un nodo de Kubernetes para alojar cada miembro del servidor de configuración en Kubernetes. Este valor se expresa como un entero seguido de una unidad de almacenamiento en notación JEDEC. El valor por defecto es 16 Gi. Por ejemplo, si este recurso MongoDB requiere 60 gigabytes de espacio de almacenamiento, establezca este valor en 60Gi.
storageClass	string	Tipo de almacenamiento necesario para cada nodo del servidor de configuración. Puedes crear este tipo de almacenamiento como un StorageClass objeto antes de usarlo en esta especificación de objeto. Asegúrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.

spec.configSrvPodSpec.persistence.multiple.journal

tipo: colección

Permite que Kubernetes Operator cree un Reclamación de volumen persistente y monte un directorio para el diario en su propio Volumen persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puede establecer esta colección o la colección persistence.single, pero no ambas.

Escalar	Tipo de dato	Descripción
labelSelector	string	Etiqueta utilizada para vincular volúmenes montados a directorios.
storage	string	Capacidad mínima de almacenamiento que debe estar disponible en un nodo de Kubernetes para alojar cada miembro del servidor de configuración en Kubernetes. Este valor se expresa como un entero seguido de una unidad de almacenamiento en notación JEDEC. El valor por defecto es 1Gi. Por ejemplo, si este recurso MongoDB requiere 60 gigabytes de espacio de almacenamiento, establezca este valor en 60Gi.
storageClass	string	Tipo de almacenamiento necesario para cada nodo del servidor de configuración. Puedes crear este tipo de almacenamiento como un StorageClass objeto antes de usarlo en esta especificación de objeto. Asegúrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.

spec.configSrvPodSpec.persistence.multiple.logs

tipo: colección

Hace que el operador de Kubernetes cree un Reclamo de volumen persistente y monte un directorio para los registros en su propio Volumen Persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puede establecer esta colección o la colección persistence.single, pero no ambas.

Escalar	Tipo de dato	Descripción
labelSelector	string	Etiqueta utilizada para vincular volúmenes montados a directorios.
storage	string	Capacidad mínima de almacenamiento que debe estar disponible en un nodo de Kubernetes para alojar cada miembro del servidor de configuración en Kubernetes. Este valor se expresa como un entero seguido de una unidad de almacenamiento en notación JEDEC. El valor por defecto es 3Gi. Por ejemplo, si este recurso MongoDB requiere 60 gigabytes de espacio de almacenamiento, establezca este valor en 60Gi.
storageClass	string	Tipo de almacenamiento necesario para cada nodo del servidor de configuración. Puedes crear este tipo de almacenamiento como un StorageClass objeto antes de usarlo en esta especificación de objeto. Asegúrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.

spec.configSrvPodSpec.podTemplate

tipo: colección

Plantilla para los pods de Kubernetes que el operador de controladores MongoDB para Kubernetes crea para cada miembro del servidor de configuración.

Los valores de la plantilla tienen prioridad sobre los valores especificados en spec.configSrvPodSpec.

Nota

El Operador de Kubernetes no valida los campos que se proporcionan en spec.configSrvPodSpec.podTemplate.

spec.configSrvPodSpec.podTemplate.metadata

tipo: colección

Metadatos para los Pods de Kubernetes que el MongoDB Controllers for Kubernetes Operator crea para cada nodo del servidor de configuración.

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

spec.configSrvPodSpec.podTemplate.spec

tipo: colección

Especificaciones de los pods de Kubernetes que el operador de controladores MongoDB para Kubernetes crea para cada miembro del servidor de configuración.

Para revisar los campos que puedes añadir a spec.configSrvPodSpec.podTemplate.spec, consulta la Kubernetes PodSpec v1 Core API.

Nota

Cuando añades contenedores a spec.configSrvPodSpec.podTemplate.spec.containers, el Kubernetes operador los agrega al pod de Kubernetes. Estos contenedores se agregan a cada contenedor de nodos del servidor de configuración en el pod.

Utiliza esta configuración para especificar la asignación de CPU y RAM para cada pod. Para obtener ejemplos, consulta las muestras en GitHub.

spec.configSrvPodSpec.podTemplate.spec.affinity.podAffinity

tipo: colección

Regla de Kubernetes para determinar si varios recursos MongoDB Pods deben estar ubicados junto con otros Pods. Para obtener más información sobre los casos de uso, consulta afinidad y anti-afinidad en la documentación de Kubernetes.

spec.configSrvPodSpec.podTemplate.spec.affinity.nodeAffinity

tipo: colección

Regla de Kubernetes para colocar pods para el conjunto de réplicas en un rango específico de nodos.

Para un rendimiento de lectura-escritura optimizado, utiliza reglas de afinidad de nodos que restrinjan los Pods para ejecutarse en nodos en particular, o para dar preferencia a la ejecución en nodos en particular.

spec.configSrvPodSpec.podTemplate.spec.affinity.podAntiAffinity

Tipo: string

Default: kubernetes.io/hostname

Establece una regla para distribuir Pods que alojan el recurso MongoDB en diferentes ubicaciones. Una ubicación puede ser un solo nodo, rack o región. De forma predeterminada, el operador de Kubernetes intenta distribuir los pods entre diferentes nodos.

spec.configSrvPodSpec.podTemplate.spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey

Tipo: string

Default: kubernetes.io/hostname

Esta clave define qué etiqueta se usa para determinar a qué dominio de la topología pertenece un nodo.

spec.mongodsPerShardCount

Tipo: entero

Obligatorio. Número de miembros por fragmento.

spec.mongosCount

Tipo: entero

Obligatorio. Número de mongos instancias en el clúster particionado.

spec.mongos.additionalMongodConfig

tipo: colección

Opciones de configuración adicionales con las que desea iniciar cada instancia de mongos.

El operador de Kubernetes admite todas las opciones de configuración que admite la versión de MongoDB que implementa a través del agente de MongoDB, excepto que el operador de Kubernetes anula los valores que proporciona para cualquiera de las siguientes opciones:

• net.tls.certificateKeyFile

• net.tls.clusterFile

• replication.replSetName

• security.clusterAuthMode

• sharding.clusterRole

• storage.dbPath

• systemLog.destination

• systemLog.path

Para obtener más información sobre las opciones de configuración que posee el operador de Kubernetes, consulte Configuración exclusiva del operador de Kubernetes de MongoDB.

Para saber qué opciones de configuración puedes utilizar, consulta Opciones avanzadas para implementaciones de MongoDB en la documentación de Ops Manager.

spec.mongos.agent

tipo: colección

Configuración de MongoDB Agent para cada instancia mongos.

spec.mongos.agent.startupOptions

tipo: colección

Configuración de MongoDB Agent con la que se desea iniciar cada instancia de mongos.

Debe proporcionar la configuración de MongoDB Agent como pares clave-valor. Los valores deben ser cadenas.

Para obtener una lista de la configuración admitida de MongoDB Agent, consulta:

• Configuración del agente MongoDB para proyectos de Cloud Manager.

• Configuración del MongoDB Agent para la versión de Ops Manager que implementaste con el operador de Kubernetes.

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: my-sharded-cluster-options
6
spec:
7
  version: "8.0.0"
8
  type: ShardedCluster
9
  opsManager:
10
    configMapRef:
11
      name: my-project
12
  credentials: my-credentials
13
  persistent: true
14
  shardCount: 2
15
  mongodsPerShardCount: 3
16
  mongosCount: 2
17
  configServerCount: 1
18
19
  mongos:
20
    agent:
21
      startupOptions:
22
        maxLogFiles: "30"
23
24
  configSrv:
25
     agent:
26
       startupOptions:
27
         dialTimeoutSeconds: "40"
28
  shard:
29
     agent:
30
       startupOptions:
31
         serverSelectionTimeoutSeconds: "20"
32
...

spec.mongosPodSpec

Tipo: objeto

Objeto que contiene las especificaciones para los Pods de mongos de MongoDB CustomResourceDefinition.

spec.mongosPodSpec.podTemplate

tipo: colección

Plantilla para los Pods de Kubernetes que los Controladores de MongoDB para el Operador de Kubernetes crean para cada instancia mongos.

Los valores de la plantilla tienen prioridad sobre los valores especificados en spec.mongosPodSpec.

Nota

El Operador de Kubernetes no valida los campos que se proporcionan en spec.mongosPodSpec.podTemplate.

spec.mongosPodSpec.podTemplate.metadata

tipo: colección

Metadatos para los Kubernetes Pods que los Controladores de MongoDB para el Operador de Kubernetes crea para cada instancia mongos.

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

spec.mongosPodSpec.podTemplate.spec

tipo: colección

Especificaciones de los Pods de Kubernetes que los Controladores de MongoDB operador crean para cada mongos instancia.

Para revisar los campos que puedes añadir a spec.mongosPodSpec.podTemplate.spec, consulta la Kubernetes PodSpec v1 Core API.

Nota

Cuando añades contenedores a spec.mongosPodSpec.podTemplate.spec.containers, el Kubernetes operador los agrega al pod de Kubernetes. Estos contenedores se anexan a cada mongos de contenedores de instancias del pod.

Utiliza esta configuración para especificar la asignación de CPU y RAM para cada pod. Para obtener ejemplos, consulta las muestras en GitHub.

spec.mongosPodSpec.podTemplate.spec.affinity.podAffinity

tipo: colección

opcional. Kubernetes regla para determinar si varios Pods de recursos MongoDB deben ubicarse junto con otros Pods.

spec.mongosPodSpec.podTemplate.spec.affinity.nodeAffinity

tipo: colección

Regla de Kubernetes para colocar pods para el conjunto de réplicas en un rango específico de nodos.

Para un rendimiento de lectura-escritura optimizado, utiliza reglas de afinidad de nodos que restrinjan los Pods para ejecutarse en nodos en particular, o para dar preferencia a la ejecución en nodos en particular.

spec.mongosPodSpec.podTemplate.spec.affinity.podAntiAffinity

Tipo: string

Default: kubernetes.io/hostname

Establece una regla para distribuir Pods que alojan el recurso MongoDB en diferentes ubicaciones. Una ubicación puede ser un solo nodo, rack o región. De forma predeterminada, el operador de Kubernetes intenta distribuir los pods entre diferentes nodos.

spec.mongosPodSpec.podTemplate.spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey

Tipo: string

Default: kubernetes.io/hostname

Esta clave define qué etiqueta se usa para determinar a qué dominio de la topología pertenece un nodo.

spec.shardCount

Tipo: entero

Obligatorio. Número de particiones en el clúster.

spec.shard.additionalMongodConfig

tipo: colección

Opciones de configuración adicionales con las que desea iniciar cada miembro del fragmento del clúster fragmentado.

El operador de Kubernetes admite todas las opciones de configuración que admite la versión de MongoDB que implementa a través del agente de MongoDB, excepto que el operador de Kubernetes anula los valores que proporciona para cualquiera de las siguientes opciones:

• net.tls.certificateKeyFile

• net.tls.clusterFile

• replication.replSetName

• security.clusterAuthMode

• sharding.clusterRole

• storage.dbPath

• systemLog.destination

• systemLog.path

Para obtener más información sobre las opciones de configuración que posee el operador de Kubernetes, consulte Configuración exclusiva del operador de Kubernetes de MongoDB.

Para saber qué opciones de configuración puedes utilizar, consulta Opciones avanzadas para implementaciones de MongoDB en la documentación de Ops Manager.

spec.shard.agent

tipo: colección

Configuración del agente MongoDB para cada miembro del fragmento del clúster fragmentado.

spec.shard.agent.startupOptions

tipo: colección

Ajustes del MongoDB Agent con los que deseas iniciar cada nodo del la partición del clúster.

Debe proporcionar la configuración de MongoDB Agent como pares clave-valor. Los valores deben ser cadenas.

Para obtener una lista de la configuración admitida de MongoDB Agent, consulta:

• Configuración del agente MongoDB para proyectos de Cloud Manager.

• Configuración del MongoDB Agent para la versión de Ops Manager que implementaste con el operador de Kubernetes.

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: my-sharded-cluster-options
6
spec:
7
  version: "8.0.0"
8
  type: ShardedCluster
9
  opsManager:
10
    configMapRef:
11
      name: my-project
12
  credentials: my-credentials
13
  persistent: true
14
  shardCount: 2
15
  mongodsPerShardCount: 3
16
  mongosCount: 2
17
  configServerCount: 1
18
19
  mongos:
20
    agent:
21
      startupOptions:
22
        maxLogFiles: "30"
23
24
  configSrv:
25
     agent:
26
       startupOptions:
27
         dialTimeoutSeconds: "40"
28
  shard:
29
     agent:
30
       startupOptions:
31
         serverSelectionTimeoutSeconds: "20"
32
...

spec.shardPodSpec

Tipo: objeto

Objeto que contiene las especificaciones para el MongoDB CustomResourceDefinition partición Pods.

spec.shardPodSpec.persistence.multiple.data

tipo: colección

Hace que el operador de Kubernetes cree un reclamo de volumen persistente y monte un directorio para datos en su propio volumen persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puede establecer esta colección o la colección persistence.single, pero no ambas.

Escalar	Tipo de dato	Descripción
labelSelector	string	Etiqueta utilizada para vincular volúmenes montados a directorios.
storage	string	Capacidad mínima de almacenamiento que debe estar disponible en un nodo de Kubernetes para alojar cada nodo de un clúster en Kubernetes. Este valor se expresa como un número entero seguido de una unidad de almacenamiento en notación JEDEC. El valor por defecto es 16 Gi. Por ejemplo, si este recurso MongoDB requiere 60 gigabytes de espacio de almacenamiento, establezca este valor en 60Gi.
storageClass	string	Tipo de almacenamiento necesario para cada miembro del fragmento del clúster fragmentado. Puede crear este tipo de almacenamiento como un objeto StorageClass antes de usarlo en esta especificación de objeto. Asegúrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.

spec.shardPodSpec.persistence.multiple.journal

tipo: colección

Permite que Kubernetes Operator cree un Reclamación de volumen persistente y monte un directorio para el diario en su propio Volumen persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puede establecer esta colección o la colección persistence.single, pero no ambas.

Escalar	Tipo de dato	Descripción
labelSelector	string	Etiqueta utilizada para vincular volúmenes montados a directorios.
storage	string	Capacidad mínima de almacenamiento que debe estar disponible en un nodo de Kubernetes para alojar cada nodo de un clúster en Kubernetes. Este valor se expresa como un número entero seguido de una unidad de almacenamiento en notación JEDEC. El valor por defecto es 1Gi. Por ejemplo, si este recurso MongoDB requiere 60 gigabytes de espacio de almacenamiento, establezca este valor en 60Gi.
storageClass	string	Tipo de almacenamiento necesario para cada miembro del fragmento del clúster fragmentado. Puede crear este tipo de almacenamiento como un objeto StorageClass antes de usarlo en esta especificación de objeto. Asegúrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.

spec.shardPodSpec.persistence.multiple.logs

tipo: colección

Hace que el operador de Kubernetes cree un Reclamo de volumen persistente y monte un directorio para los registros en su propio Volumen Persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puede establecer esta colección o la colección persistence.single, pero no ambas.

Escalar	Tipo de dato	Descripción
labelSelector	string	Etiqueta utilizada para vincular volúmenes montados a directorios.
storage	string	Capacidad mínima de almacenamiento que debe estar disponible en un nodo de Kubernetes para alojar cada nodo de un clúster en Kubernetes. Este valor se expresa como un número entero seguido de una unidad de almacenamiento en notación JEDEC. El valor por defecto es 3Gi. Por ejemplo, si este recurso MongoDB requiere 60 gigabytes de espacio de almacenamiento, establezca este valor en 60Gi.
storageClass	string	Tipo de almacenamiento necesario para cada miembro del fragmento del clúster fragmentado. Puede crear este tipo de almacenamiento como un objeto StorageClass antes de usarlo en esta especificación de objeto. Asegúrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.

spec.shardPodSpec.podTemplate

tipo: colección

Plantilla para los pods de Kubernetes que el operador de controladores MongoDB para Kubernetes crea para cada miembro del fragmento del clúster fragmentado.

Los valores de la plantilla tienen prioridad sobre los valores especificados en spec.shardPodSpec.

Nota

El Operador de Kubernetes no valida los campos que se proporcionan en spec.shardPodSpec.podTemplate.

spec.shardPodSpec.podTemplate.metadata

tipo: colección

Metadatos para los pods de Kubernetes que el operador MongoDB Controllers for Kubernetes crea para cada nodo de particiones de clúster.

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

spec.shardPodSpec.podTemplate.spec

tipo: colección

Especificaciones de los pods de Kubernetes que los controladores de MongoDB para el operador de Kubernetes crean para cada nodo de clúster.

Para revisar los campos que puedes añadir a spec.shardPodSpec.podTemplate.spec, consulta la Kubernetes PodSpec v1 Core API.

Nota

Cuando añades contenedores a spec.shardPodSpec.podTemplate.spec.containers, el Kubernetes operador los agrega al pod de Kubernetes. Estos contenedores se anexan a cada uno de los contenedores de los nodos de particiones del clúster en el pod.

Utiliza esta configuración para especificar la asignación de CPU y RAM para cada pod. Para obtener ejemplos, consulta las muestras en GitHub.

spec.shardPodSpec.podTemplate.spec.affinity.podAffinity

Tipo: string

Regla de Kubernetes para determinar si varios recursos MongoDB Pods deben estar ubicados junto con otros Pods. Para obtener más información sobre los casos de uso, consulta afinidad y anti-afinidad en la documentación de Kubernetes.

spec.shardPodSpec.podTemplate.spec.affinity.nodeAffinity

Tipo: string

Regla de Kubernetes para colocar pods para el conjunto de réplicas en un rango específico de nodos.

Para un rendimiento de lectura-escritura optimizado, utiliza reglas de afinidad de nodos que restrinjan los Pods para ejecutarse en nodos en particular, o para dar preferencia a la ejecución en nodos en particular.

spec.shardPodSpec.podTemplate.spec.affinity.podAntiAffinity

Tipo: string

Default: kubernetes.io/hostname

Establece una regla para distribuir Pods que alojan el recurso MongoDB en diferentes ubicaciones. Una ubicación puede ser un solo nodo, rack o región. De forma predeterminada, el operador de Kubernetes intenta distribuir los pods entre diferentes nodos.

spec.shardPodSpec.podTemplate.spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey

Tipo: string

Default: kubernetes.io/hostname

Esta clave define qué etiqueta se usa para determinar a qué dominio de la topología pertenece un nodo.

spec.shardSpecificPodSpec

Tipo: arreglo

Lista que contiene anulaciones de StatefulSet por fragmento.

spec.shardSpecificPodSpec.podTemplate

tipo: colección

Plantilla para los Pods de Kubernetes que los Controladores MongoDB para Kubernetes operador crean para la partición específica.

Los valores de la plantilla tienen prioridad sobre los valores especificados en spec.shardSpecificPodSpec.

Nota

El Operador de Kubernetes no valida los campos que se proporcionan en spec.shardSpecificPodSpec.podTemplate.

spec.shardSpecificPodSpec.podTemplate.metadata

tipo: colección

Metadatos para los pods de Kubernetes que los controladores de MongoDB para el operador de Kubernetes crean para la partición específica.

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

spec.shardSpecificPodSpec.podTemplate.spec

tipo: colección

Especificaciones de los pods de Kubernetes que los controladores de MongoDB del operador de MongoDB para Kubernetes crean para la partición específica.

Para revisar los campos que puedes añadir a spec.shardSpecificPodSpec.podTemplate.spec, consulta la Kubernetes PodSpec v1 Core API.

Nota

Al agregar contenedores a spec.shardSpecificPodSpec.podTemplate.spec.containers, el operador de Kubernetes los agrega al pod de Kubernetes. Estos contenedores se agregan a los contenedores de fragmentos específicos del pod.

Utiliza esta configuración para especificar la asignación de CPU y RAM para cada pod. Para obtener ejemplos, consulta las muestras en GitHub.

spec.shardSpecificPodSpec.podTemplate.spec.affinity.podAffinity

Tipo: string

Regla de Kubernetes para determinar si varios recursos MongoDB Pods deben estar ubicados junto con otros Pods. Para obtener más información sobre los casos de uso, consulta afinidad y anti-afinidad en la documentación de Kubernetes.

spec.shardSpecificPodSpec.podTemplate.spec.affinity.podAntiAffinity

Tipo: string

Default: kubernetes.io/hostname

Establece una regla para distribuir Pods que alojan el recurso MongoDB en diferentes ubicaciones. Una ubicación puede ser un solo nodo, rack o región. De forma predeterminada, el operador de Kubernetes intenta distribuir los pods entre diferentes nodos.

spec.shardSpecificPodSpec.podTemplate.spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey

Tipo: string

Default: kubernetes.io/hostname

Esta clave define qué etiqueta se usa para determinar a qué dominio de la topología pertenece un nodo.

spec.topology

Tipo: string

Opcional

Por defecto: SingleCluster

Define la topología del clúster fragmentado. No puede cambiarse para una implementación existente. Si se establece en MultiCluster:

• Todos los componentes del clúster fragmentado deben tener clusterSpecList definido:

  • spec.mongos.clusterSpecList

  • spec.configSrv.clusterSpecList

  • spec.shard.clusterSpecList

• Los siguientes campos se ignoran, ya que sus valores equivalentes se pasan para cada clúster en los objetos spec.<section>.clusterSpecList:

  • spec.mongodsPerShardCount se define en spec.shard.clusterSpecList.members

  • spec.mongosCount se define en spec.mongos.clusterSpecList.members

  • spec.configServerCount se define en spec.configSrv.clusterSpecList.members

  • spec.shardOverrides.memberConfig se define en spec.shardOverrides.clusterSpecList.memberConfig

  • spec.shardOverrides.members se define en spec.shardOverrides.clusterSpecList.members

  • spec.shardOverrides.statefulSet se define en spec.shardOverrides.clusterSpecList.statefulSet

Ejemplo:

apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: sc
spec:
  shardCount: 3
  # we don't specify mongodsPerShardCount, mongosCount and configServerCount as they don't make sense for multi-cluster
  topology: MultiCluster
  type: ShardedCluster
  version: 7.0.12
  cloudManager:
    configMapRef:
      name: my-project
  credentials: my-credentials
  persistent: true
  shard:
    clusterSpecList:
      - clusterName: member-cluster-0
        members: 2 # each shard will have 2 members in cluster 0, unless overriden
      - clusterName: member-cluster-1
        members: 2
      - clusterName: member-cluster-2
        members: 1
  shardOverrides:
    - shardNames: [sc-2] # this override will apply to the third shard (here, shards are indexed from 0 to 2 as we have 3 shards)
      clusterSpecList:
        - clusterName: member-cluster-0 # all other fields are optional, if not provided the fields from matching member cluster from shard.clusterSpecList will be taken by default
          members: 3
        - clusterName: member-cluster-1 # we don't deploy this shard to member-cluster-1
          # Note that it is also possible to make it explicit with members: 0
        # we don't provide entry for clusterName: member-cluster-1, so it won't be deployed there
        - clusterName: member-cluster-2
          members: 2
  configSrv:
    clusterSpecList:
      - clusterName: member-cluster-0
        members: 2 # config server will have 2 members in this cluster
      - clusterName: member-cluster-1
        members: 1
      - clusterName: member-cluster-2
        members: 2
  mongos:
    clusterSpecList:
      - clusterName: member-cluster-0
        members: 2 # router will have 2 members in this cluster
      - clusterName: member-cluster-1
        members: 1

Los siguientes campos se refieren exclusivamente a implementaciones en las que topology=MultiCluster:

spec.configSrv.clusterSpecList

Nota

Este campo está disponible exclusivamente para implementaciones de clústeres fragmentados de múltiples clústeres.

Tipo: arreglo de objetos

Obligatorio si topology=MultiCluster

Un arreglo de objetos para uso en implementaciones de clústeres particionados multiclúster con los siguientes campos de nivel superior:

clusterName

Tipo: string

Nombre del clúster donde el operador de controladores MongoDB para Kubernetes programa el StatefulSet.

externalAccess

tipo: colección

Especificación para exponer tu implementación de MongoDB en multi-Kubernetes para conexiones externas. Para aprender cómo conectarse a su implementación de MongoDB Multi-Kubernetes desde fuera del clúster de Kubernetes, consulte Conectarse al recurso multi-clúster desde fuera de Kubernetes.

Esta configuración se aplica a los servicios de todos los clústeres. Para anular esta configuración global en un clúster específico, utilice spec.clusterSpecList.externalAccess.externalService.

Si añades spec.externalAccess, el Operador de Kubernetes crea un servicio externo para cada Pod en un set de réplicas. Los servicios externos proporcionan un punto de entrada externo para cada pod de la base de datos MongoDB en un clúster. Cada servicio externo tiene selectores que emparejan el servicio externo con 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 por defecto:

Campo	Valor	Descripción
Name	<pod-name>-svc-external	Nombre del Servicio externo. No puedes cambiar este valor.
Type	LoadBalancer	Crea un servicio externo LoadBalancer.
Port	<Port Number>	Un puerto para mongod.
publishNotReadyAddress	true	Especifica que registros DNS se crean incluso si el Pod no está listo. No configures false para ningún Pod de base de datos.

Nota

Si establece spec.clusterSpecList.externalAccess.externalDomain, el servicio externo agrega otro puerto (Port Number + 1) para copias de seguridad.

members

Tipo: número

Número de miembros en el set de réplicas de MongoDB.

memberConfig

tipo: colección

Especificación para cada partición de MongoDB y sus miembros en tu implementación de clúster multi-Kubernetes de MongoDB.

El orden de los elementos en el objeto para partición debe reflejar el orden de los miembros en el set de réplicas. Por ejemplo, el primer elemento afecta al Pod en el índice 0, el segundo elemento afecta al índice 1, y así sucesivamente.

Ejemplo

Se debe considerar el siguiente ejemplo de especificación para una implementación de MongoDB en un clúster multi-Kubernetes con tres sets de réplicas:

apiVersion: mongodb.com/v1
kind: MongoDBMultiCluster
metadata:
  name: multi-replica-set
spec:
  version: 8.0.0
  type: ReplicaSet
  duplicateServiceObjects: false
  credentials: my-credentials
  opsManager:
    configMapRef:
      name: my-project
  clusterSpecList:
    - clusterName: cluster1.example.com
      members: 2
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
          - votes: 1
            priority: "1.5"
            tags:
                  tag2: "value2"
                  environment: "prod"
    - clusterName: cluster2.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
    - clusterName: cluster3.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"

podSpec.persistence

tipo: colección

Solo disponible en clusterSpecItem los objetos transferidos a spec.configSrv.clusterSpecList spec.shard.clusterSpecListy. Anula la configuración de persistencia existente para un clúster determinado.

statefulSet

tipo: colección

Proporciona la configuración para la anulación de StatefulSet para cada uno de los StatefulSets del clúster en una implementación de MongoDB en clústeres múltiples de Kubernetes. Para configurar la configuración global que se aplica a todos los clústeres en tu implementación de clústeres múltiples de MongoDB en Kubernetes, consulta spec.statefulSet.spec.

Esta configuración se aplica solo a tipos de recursos de sets de réplicas en implementaciones de MongoDB multiclúster en Kubernetes.

spec.duplicateServiceObjects

Nota

Este campo está disponible exclusivamente para implementaciones de clústeres fragmentados de múltiples clústeres.

Tipo: booleano

Opcional

Por defecto: true

Se ignora si la topología no es MultiCluster. Se aplica a los servicios para todos los componentes del clúster fragmentado: mongos, configSrv y shards.

Si se configura en true:

El operador de Kubernetes crea todos los Pod Services de todos los clústeres miembros en cada clúster miembro.

Si se configura en false:

El Operador de Kubernetes crea solo

spec.mongos.clusterSpecList

Nota

Este campo está disponible exclusivamente para implementaciones de clústeres fragmentados de múltiples clústeres.

Tipo: arreglo de objetos

Obligatorio si topology=MultiCluster

Un arreglo de objetos para uso en implementaciones de clústeres particionados multiclúster con los siguientes campos de nivel superior:

clusterName

Tipo: string

Nombre del clúster donde el operador de controladores MongoDB para Kubernetes programa el StatefulSet.

externalAccess

tipo: colección

Especificación para exponer tu implementación de MongoDB en multi-Kubernetes para conexiones externas. Para aprender cómo conectarse a su implementación de MongoDB Multi-Kubernetes desde fuera del clúster de Kubernetes, consulte Conectarse al recurso multi-clúster desde fuera de Kubernetes.

Esta configuración se aplica a los servicios de todos los clústeres. Para anular esta configuración global en un clúster específico, utilice spec.clusterSpecList.externalAccess.externalService.

Si añades spec.externalAccess, el Operador de Kubernetes crea un servicio externo para cada Pod en un set de réplicas. Los servicios externos proporcionan un punto de entrada externo para cada pod de la base de datos MongoDB en un clúster. Cada servicio externo tiene selectores que emparejan el servicio externo con 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 por defecto:

Campo	Valor	Descripción
Name	<pod-name>-svc-external	Nombre del Servicio externo. No puedes cambiar este valor.
Type	LoadBalancer	Crea un servicio externo LoadBalancer.
Port	<Port Number>	Un puerto para mongod.
publishNotReadyAddress	true	Especifica que registros DNS se crean incluso si el Pod no está listo. No configures false para ningún Pod de base de datos.

Nota

Si establece spec.clusterSpecList.externalAccess.externalDomain, el servicio externo agrega otro puerto (Port Number + 1) para copias de seguridad.

members

Tipo: número

Número de miembros en el set de réplicas de MongoDB.

memberConfig

tipo: colección

Especificación para cada partición de MongoDB y sus miembros en tu implementación de clúster multi-Kubernetes de MongoDB.

El orden de los elementos en el objeto para partición debe reflejar el orden de los miembros en el set de réplicas. Por ejemplo, el primer elemento afecta al Pod en el índice 0, el segundo elemento afecta al índice 1, y así sucesivamente.

Ejemplo

Se debe considerar el siguiente ejemplo de especificación para una implementación de MongoDB en un clúster multi-Kubernetes con tres sets de réplicas:

apiVersion: mongodb.com/v1
kind: MongoDBMultiCluster
metadata:
  name: multi-replica-set
spec:
  version: 8.0.0
  type: ReplicaSet
  duplicateServiceObjects: false
  credentials: my-credentials
  opsManager:
    configMapRef:
      name: my-project
  clusterSpecList:
    - clusterName: cluster1.example.com
      members: 2
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
          - votes: 1
            priority: "1.5"
            tags:
                  tag2: "value2"
                  environment: "prod"
    - clusterName: cluster2.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
    - clusterName: cluster3.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"

statefulSet

tipo: colección

Proporciona la configuración para la anulación de StatefulSet para cada uno de los StatefulSets del clúster en una implementación de MongoDB en clústeres múltiples de Kubernetes. Para configurar la configuración global que se aplica a todos los clústeres en tu implementación de clústeres múltiples de MongoDB en Kubernetes, consulta spec.statefulSet.spec.

Esta configuración se aplica solo a tipos de recursos de sets de réplicas en implementaciones de MongoDB multiclúster en Kubernetes.

spec.shard.clusterSpecList

Nota

Este campo está disponible exclusivamente para implementaciones de clústeres fragmentados de múltiples clústeres.

Tipo: arreglo de objetos

Obligatorio si topology=MultiCluster

Un arreglo de objetos para uso en implementaciones de clústeres particionados multiclúster con los siguientes campos de nivel superior:

clusterName

Tipo: string

Nombre del clúster donde el operador de controladores MongoDB para Kubernetes programa el StatefulSet.

externalAccess

tipo: colección

Especificación para exponer tu implementación de MongoDB en multi-Kubernetes para conexiones externas. Para aprender cómo conectarse a su implementación de MongoDB Multi-Kubernetes desde fuera del clúster de Kubernetes, consulte Conectarse al recurso multi-clúster desde fuera de Kubernetes.

Esta configuración se aplica a los servicios de todos los clústeres. Para anular esta configuración global en un clúster específico, utilice spec.clusterSpecList.externalAccess.externalService.

Si añades spec.externalAccess, el Operador de Kubernetes crea un servicio externo para cada Pod en un set de réplicas. Los servicios externos proporcionan un punto de entrada externo para cada pod de la base de datos MongoDB en un clúster. Cada servicio externo tiene selectores que emparejan el servicio externo con 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 por defecto:

Campo	Valor	Descripción
Name	<pod-name>-svc-external	Nombre del Servicio externo. No puedes cambiar este valor.
Type	LoadBalancer	Crea un servicio externo LoadBalancer.
Port	<Port Number>	Un puerto para mongod.
publishNotReadyAddress	true	Especifica que registros DNS se crean incluso si el Pod no está listo. No configures false para ningún Pod de base de datos.

Nota

Si establece spec.clusterSpecList.externalAccess.externalDomain, el servicio externo agrega otro puerto (Port Number + 1) para copias de seguridad.

members

Tipo: número

Número de miembros en el set de réplicas de MongoDB.

memberConfig

tipo: colección

Especificación para cada partición de MongoDB y sus miembros en tu implementación de clúster multi-Kubernetes de MongoDB.

El orden de los elementos en el objeto para partición debe reflejar el orden de los miembros en el set de réplicas. Por ejemplo, el primer elemento afecta al Pod en el índice 0, el segundo elemento afecta al índice 1, y así sucesivamente.

Ejemplo

Se debe considerar el siguiente ejemplo de especificación para una implementación de MongoDB en un clúster multi-Kubernetes con tres sets de réplicas:

apiVersion: mongodb.com/v1
kind: MongoDBMultiCluster
metadata:
  name: multi-replica-set
spec:
  version: 8.0.0
  type: ReplicaSet
  duplicateServiceObjects: false
  credentials: my-credentials
  opsManager:
    configMapRef:
      name: my-project
  clusterSpecList:
    - clusterName: cluster1.example.com
      members: 2
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
          - votes: 1
            priority: "1.5"
            tags:
                  tag2: "value2"
                  environment: "prod"
    - clusterName: cluster2.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
    - clusterName: cluster3.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"

podSpec.persistence

tipo: colección

Solo disponible en clusterSpecItem los objetos transferidos a spec.configSrv.clusterSpecList spec.shard.clusterSpecListy. Anula la configuración de persistencia existente para un clúster determinado.

statefulSet

tipo: colección

Proporciona la configuración para la anulación de StatefulSet para cada uno de los StatefulSets del clúster en una implementación de MongoDB en clústeres múltiples de Kubernetes. Para configurar la configuración global que se aplica a todos los clústeres en tu implementación de clústeres múltiples de MongoDB en Kubernetes, consulta spec.statefulSet.spec.

Esta configuración se aplica solo a tipos de recursos de sets de réplicas en implementaciones de MongoDB multiclúster en Kubernetes.

spec.shardOverrides

Tipo: arreglo de objetos

Opcional

Lista que contiene las anulaciones por fragmento. Cada objeto contiene los siguientes campos:

• shardNames

  Requerido

  El nombre de la partición al que se aplica esta anulación.

• podSpec.Persistence

  Opcional

  Define cómo el operador de Kubernetes crea y vincula volúmenes persistentes a fragmentos. Para topology=MultiCluster, establece la configuración de persistencia para todos los clústeres miembros. Puede definir la configuración de persistencia para un clúster miembro específico en spec.shardOverrides.clusterSpecList.persistence.

• additionalMongodConfig

  Opcional

  Anulación específica de la partición para spec.shard.additionalMongodConfig.

• agent

  Opcional

  Anulación específica de la partición para spec.shard.agent.

• statefulSet

  Opcional

  Instrucción específica de partición para spec.shardPodSpec.podTemplate y spec.shard.clusterSpecList.statefulSet.

• members

  Opcional

  Disponible solo cuando topology=SingleCluster. Anulación específica de partición para anulación para spec.mongodsPerShardCount.

• memberConfig

  Opcional

  Disponible solo cuando topology=SingleCluster. Anulación específica de partición para spec.shard.memberConfig.

spec.shardPodSpec.persistence.single

tipo: colección

Haga que el Operador de Kubernetes cree un Reclamo de Volumen Persistente y monte los tres directorios de datos, diario y registros en un mismo Volumen Persistente.

Nota

• Debes establecer los valores en esta colección spec.persistent : true si.

• Puedes definir esta colección o bien las persistence.multiple colecciones pero no ambas.

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 por defecto es 16 Gi. Por ejemplo, si cada nodo de partición de clúster 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úrate de establecer el StorageClass reclaimPolicy como Retain. Esto garantiza que los datos se conserven cuando se elimine una Solicitud de Volumen Persistente.