/ /

Archivo de configuración del clúster

Overview

El mongocli El comando requiere ajustes de configuración del clúster para crear o actualizar un Clúster de MongoDB Cloud Manager o MongoDB Ops Manager. Las propiedades de .yaml .json configuración se pueden proporcionar mediante un archivo o. Las siguientes secciones describen las propiedades de configuración necesarias para crear o actualizar un clúster y proporcionan un archivo de configuración de ejemplo que puede copiar y modificar.

Propiedades de configuración

Las siguientes secciones contienen:

Propiedades de configuración de todo el clúster
Propiedades de configuración de miembros del conjunto de réplicas
Propiedades de configuración del clúster fragmentado

Configuración de todo el clúster

El archivo de configuración para crear o actualizar un clúster de MongoDB Cloud Manager o MongoDB Ops Manager debe contener las siguientes configuraciones para todo el clúster:

Campo	Tipo	Descripción
`name`	string	Nombre del cluster.
`version`	string	Versión del proceso a `mongod` implementar.
`featureCompatibilityVersion`	string	Versión de compatibilidad de características entre versiones de la implementación.
`processes`	matriz de objetos	Requerido para conjuntos de réplicas. Una matriz de objetos que contiene la configuración de cada proceso.`mongod` Cada `mongod` tiene Configuración de miembros del conjunto de réplicas.
`shards`	matriz de objetos	Requerido para clústeres fragmentados. Una matriz de objetos que contiene la configuración de cada fragmento.
`config`	Objeto	Requerido para clústeres fragmentados. Objeto que contiene el conjunto de réplicas del servidor de configuración.
`mongos`	matriz de objetos	Requerido para clústeres fragmentados. Una matriz de objetos que contiene la configuración de cada `mongos` instancia.

Configuración de miembros del conjunto de réplicas

El archivo de configuración para crear o actualizar un clúster de MongoDB Cloud Manager o MongoDB Ops Manager puede contener las siguientes configuraciones para cada miembro del conjunto de réplicas:

Campo

Tipo

Descripción

¿Obligatorio?

auditLogDestination

string

Configuración que habilita la auditoría y especifica dónde enviar todos los eventos de auditoría. La CLI de MongoDB acepta los siguientes valores:

syslog
Genera los eventos de auditoría en syslog en formato JSON.
console
Genera los eventos de auditoría en stdout en formato JSON.
file
Envíe los eventos de auditoría al archivo especificado en la configuración auditLogPath en el formato especificado en la configuración auditLogFormat.

Esta configuración corresponde a la opción del archivo de configuración auditLog.destination.

auditLogFilter

string

Configuración que filtra los eventos que se auditan. El filtro limita los resultados para que coincidan con la consulta especificada.

Para obtener más información sobre cómo crear filtros, consulte Configurar filtros de auditoría.

Esta configuración corresponde a la opción del archivo de configuración auditLog.filter.

auditLogFormat

string

Formato del archivo de salida para auditoría si auditLogDestination está establecido file en.

La CLI de MongoDB acepta los siguientes valores:

JSON
Envíe los eventos de auditoría en formato JSON al archivo especificado en la configuración auditLogPath.
BSON
Envíe los eventos de auditoría en formato binario BSON al archivo especificado en la configuración auditLogPath.

Esta configuración corresponde a la opción del archivo de configuración auditLog.format.

auditLogPath

string

Archivo de salida para auditoría si auditLogDestination tiene un valor file de. La auditLogPath opción puede tomar una ruta absoluta o relativa.

Esta configuración corresponde a la opción del archivo de configuración auditLog.path.

bindIp

string

Nombres de host, direcciones IP o rutas completas de sockets de dominio Unix dondemongosomongoddeben escuchar las conexiones de los clientes. Puede asociarmongosomongoda cualquier interfaz. Para asociar varias direcciones, introduzca una lista de valores separados por comas.

Esta configuración corresponde a la opción del archivo de configuración net.bindIp.

bindIpAll

booleano

Indicador que indica si la mongos instancia o se enlaza a todas las mongod 4 direcciones IPv (por ejemplo,). 0.0.0.0 Si ipv6 se establece true en, bindIpAll también se enlaza a las6 direcciones IPv (por:: ejemplo,). La CLI de MongoDB acepta los siguientes valores: true falseo.

Esta configuración corresponde a la opción del archivo de configuración net.bindIpAll.

buildIndexes

booleano

Indicador que indica si se debe indicar a la creación de índices. La CLI de MongoDB acepta los siguientes mongod valores: true falseo.

Esta configuración corresponde a la opción de configuración del conjunto de réplicas buildIndexes.

dbPath

string

Directorio donde la instancia almacena sus datos. No se puede modificar después de la mongod implementación.

sí

delay

Int

Número de segundos que este miembro debe estar detrás del miembro principal.

Esta configuración corresponde a la opción de configuración del conjunto de réplicas slaveDelay.

directoryPerDB

booleano

Indicador que indica si MongoDB debe usar un directorio independiente para almacenar los datos de cada base de datos. Los directorios se encuentran en el directorio y el nombre de cada subdirectorio corresponde al nombre de la base de storage.dbPath datos.

Por defecto, directoryPerDB es false.

Esta configuración corresponde a la storage.directoryPerDB mongod opción de configuración del conjunto de réplicas.

enableMajorityReadConcern

booleano

Marca que indica si se habilita o no "majority" la preocupación de lectura. Si se habilita, la preocupación de lectura "majority" garantiza que la mayoría de los miembros del conjunto de réplicas hayan confirmado la lectura de datos para operaciones de lectura no asociadas con transacciones multidocumento.

Por defecto, enableMajorityReadConcern es true.

Esta configuración corresponde a la opción de configuración del conjunto de réplicas replication.enableMajorityReadConcern.

hostname

string

Nombre del host que se agregará al conjunto de réplicas. Este es el host donde Ops Manager implementa el mongod proceso.

sí

inMemory.engineConfig. inMemorySizeGB

float

Cantidad máxima de memoria a asignar para los datos del motor de almacenamiento en memoria, incluidos índices, registro de operaciones si es parte del conjunto de réplicas, conjunto de réplicas o metadatos de clúster fragmentado,mongod etc.

El valor puede variar entre 256 MB y 10 TB. De forma predeterminada, el motor de almacenamiento en memoria utiliza el 50% de la RAM física menos 1 GB.

Esto solo está disponible para MongoDB Enterprise.

Esta configuración corresponde a la inMemorySizeGB mongod opción de configuración del conjunto de réplicas.

ipv6

booleano

Bandera que indica si la implementación admite IPv.6 La CLI de MongoDB acepta los siguientes valores: true falseo.

Esta configuración corresponde a la opción del archivo de configuración net.ipv.6

logDestination

string

Destino al que MongoDB envía toda la salida del registro. La CLI de MongoDB acepta los siguientes valores: file o syslog. Si especifica file, también debe especificar logPath.

Si no especifica logDestination, MongoDB envía toda la salida de registro a la salida estándar.

Esta configuración corresponde a la opción del archivo de configuración systemLog.destination.

logPath

string

Ubicación y nombre del archivo de mongod registro del proceso en el host.

sí

oplogSizeMB

entero

Tamaño máximo en megabytes para el registro de operaciones de replicación.

Esta configuración corresponde a la opción de configuración del conjunto de réplicas replication.oplogSizeMB.

port

entero

Puerto para el miembro del conjunto de réplicas. El proceso debe tener acceso exclusivo al puerto mongod especificado.

sí

priority

entero

Prioridad del miembro del conjunto de réplicas durante las elecciones. El valor puede ser:

Los miembros sin derecho a voto deben tener una prioridad de 0. Los miembros del conjunto de réplicas con una prioridad de 0 no pueden convertirse en el principal ni activar elecciones.

sí

tls.CAFile

string

.pem Archivo que contiene la cadena de certificados raíz de la autoridad de certificación. Especifique el nombre del archivo .pem mediante rutas relativas o absolutas.

Esta configuración corresponde a la opción de configuración del mongod conjunto de réplicas net.tls.CAFile.

tls. certificateKeyFile

string

.pem archivo que contiene tanto el certificado TLS como la clave.

tls.certificateKeyFile y tls.certificateSelector son mutuamente excluyentes. Solo puedes especificar uno.

Esta configuración corresponde a net.tls.certificateKeyFile. Opción de configuración de set de réplicas mongod.

tls. certificateKeyFilePassword

string

Contraseña para descifrar el archivo de clave del certificado.

Utilice la tls.certificateKeyFilePassword opción solo si el archivo de clave del certificado está cifrado. En todos los casos,mongos u eliminarán la contraseña de todos los registros e mongod informes.

Esta configuración corresponde a la opción de configuración del mongod conjunto de réplicas net.tls.certificateKeyFilePassword.

tls.certificateSelector

string

Propiedad de certificado que utiliza el agente MongoDB para seleccionar un certificado coincidente del almacén de certificados del sistema operativo para usar para TLS/SSL.

La CLI de MongoDB acepta una de las siguientes asignaciones de clave-valor como argumento de tls.certificateSelector:

Clave	Tipo de valor	Descripción
`subject`	string ASCII	El nombre del sujeto o nombre común en el certificado.
`thumbprint`	cadena hexadecimal	Una secuencia de bytes, expresada en hexadecimal, utilizada para identificar una llave pública mediante su resumen SHA-1. El `thumbprint` a veces se conoce como `fingerprint`.

tls.certificateKeyFile y tls.certificateSelector son mutuamente excluyentes. Solo puedes especificar uno.

Esta configuración corresponde a la opción de configuración del mongod conjunto de réplicas net.tls.certificateSelector.

tls. clusterCertificateSelector

string

Propiedad de certificado que utiliza el agente MongoDB para seleccionar un certificado coincidente del almacén de certificados del sistema operativo para utilizarlo en la autenticación de membresía interna x..509

La CLI de MongoDB acepta una de las siguientes asignaciones de clave-valor como argumento de tls.clusterCertificateSelector:

Clave	Tipo de valor	Descripción
`subject`	string ASCII	El nombre del sujeto o nombre común en el certificado.
`thumbprint`	cadena hexadecimal	Una secuencia de bytes, expresada en hexadecimal, utilizada para identificar una llave pública mediante su resumen SHA-1. El `thumbprint` a veces se conoce como `fingerprint`.

tls.clusterCertificateSelector y tls.clusterFile son mutuamente excluyentes. Solo puedes especificar uno.

Esta configuración corresponde a la opción de configuración del mongod conjunto de réplicas net.tls.clustercertificateSelector.

tls.clusterFile

string

.pem archivo que contiene el509 archivo de clave de certificado x.para la autenticación de membresía para el clúster o el conjunto de réplicas.

tls.clusterCertificateSelector y tls.clusterFile son mutuamente excluyentes. Solo puedes especificar uno.

Esta configuración corresponde a la opción de configuración del mongod conjunto de réplicas net.tls.clusterFile.

tls.clusterPassword

string

La contraseña para descifrar el archivo de clave de certificado x.509 especificado con tls.clusterFile.

Utilice la tls.clusterPassword opción solo si el archivo de clave del certificado está cifrado. En todos los casos,mongos u eliminarán la contraseña de todos los registros e mongod informes.

Este ajuste corresponde a la opción net.tls.clusterPassword Opción de configuración de set de réplicas mongod.

tls.CRLFile

string

El archivo .pem que contiene la Lista de revocación de certificados. Especifique el nombre del archivo .pem utilizando rutas relativas o absolutas.

Esta configuración corresponde a la opción de mongod configuración del conjunto de réplicas net.tls.CRLFile.

tls.disabledProtocols

string

Protocolos o versiones sobre los cuales un servidor MongoDB que se ejecuta con TLS rechaza las conexiones entrantes.

Esta configuración corresponde a la opción de configuración del mongod conjunto de réplicas net.tls.disabledProtocols.

tls.FIPSMode

string

Habilite o deshabilite el uso del modo FIPS de la biblioteca TLS para mongos mongodo. Su sistema debe tener una biblioteca compatible con FIPS para usar esta opción.

Esta configuración corresponde a la opción de mongod configuración del conjunto de réplicas net.tls.FIPSMode.

tls.mode

string

Habilita TLS para todas las conexiones de red. La CLI de MongoDB acepta los siguientes argumentos para esta configuración:

Valor	Descripción
`disabled`	El servidor no utiliza tls.
`allowTLS`	Las conexiones entre servidores no utilizan TLS. Para las conexiones entrantes, el servidor acepta tanto TLS como no TLS.
`preferTLS`	Las conexiones entre servidores utilizan TLS. Para las conexiones entrantes, el servidor acepta tanto TLS como no TLS.
`requireTLS`	El servidor utiliza y acepta únicamente conexiones cifradas mediante TLS.

Esta configuración corresponde a la opción de mongod configuración del conjunto de réplicas net.tls.mode.

tls.PEMKeyFile

string

.pem archivo que contiene tanto el certificado TLS como la clave.

IMPORTANTE: Esta configuración está obsoleta. Utilice tls.certificateKeyFile en su lugar.

Esta configuración corresponde a la opción de mongod configuración del conjunto de réplicas net.ssl.PEMKeyFile.

votes

entero

Número que indica si el miembro del conjunto de réplicas vota en la elección. La CLI de MongoDB acepta los siguientes valores:

0 Si el miembro del conjunto de réplicas no puede votar
1 Si el miembro del conjunto de réplicas puede votar

Para obtener más información votes sobre, consulte los votos.

sí

wiredTiger.engineConfig. cacheSizeGB

float

Tamaño máximo de la caché interna que WiredTiger utiliza para todos los datos.

El valor puede variar entre 0.25 GB y 10000 GB. De forma predeterminada, el tamaño de la caché interna de WiredTiger es el mayor de los siguientes:

50 % de (RAM - 1 GB), o
256 MB.

Se debe evitar aumentar el tamaño de la caché interna de WiredTiger por encima de su valor por defecto.

Esta configuración corresponde a la journalCompressor mongod opción de configuración del conjunto de réplicas.

wiredTiger.engineConfig. journalCompressor

string

Tipo de compresión a utilizar para comprimir los datos del journal en WiredTiger.

Los compresores disponibles son:

none
rápido
zlib
zstd (disponible para clústeres que ejecutan MongoDB 4.2 y versiones posteriores)

De forma predeterminada, WiredTiger utiliza snappy.

Esta configuración corresponde a la journalCompressor mongod opción de configuración del conjunto de réplicas.

wiredTiger.engineConfig. directoryForIndexes

booleano

Indicador que indica si almacena mongod índices y colecciones en subdirectorios separados dentro del directorio de datos (esstorage.dbPath decir,). Específicamente, mongod almacena los índices en un subdirectorio llamado index y los datos de la colección en un subdirectorio collection llamado.

Mediante un enlace simbólico, puede especificar una ubicación diferente para los índices. En concreto, cuando la mongod instancia no esté en ejecución, mueva el index subdirectorio a un nuevo destino y cree un enlace simbólico llamado index en el directorio de datos hacia el nuevo destino.

De forma predeterminada, wiredTiger.engineConfig. directoryForIndexes es false.

Esta configuración corresponde a la directoryForIndexes mongod opción de configuración del conjunto de réplicas.

wiredTiger.engineConfig. maxCacheOverflowFileSizeGB

float

Esta configuración solo es compatible con clústeres que ejecutan versiones de MongoDB:

4.0.12 a 4.0.x, y
4.2.1 a través de 4.2.x.

Tamaño máximo (en GB) para el archivo "lookaside (o overflow de caché)" llamado WiredTigerLAS.wt. El archivo ya no existe a partir de la versión 7.0 de MongoDB.

La configuración puede aceptar los siguientes valores:

Valor	Descripción
`0`	Valor predeterminado. Si se establece en `0`, el tamaño del archivo es ilimitado.
número >= 0.1	El tamaño máximo (en GB). Si el `WiredTigerLAS.wt` archivo supera este tamaño, se cierra con una aserción fatal. Puede borrar`mongod` el `WiredTigerLAS.wt` archivo y `mongod` reiniciar.

Para cambiar el tamaño máximo durante el tiempo de ejecución, utilice el parámetro wiredTigerMaxCacheOverflowSizeGB.

Esta configuración corresponde a la maxCacheOverflowSizeGB mongod opción de configuración del conjunto de réplicas.

wiredTiger.collectionConfig. blockCompressor

string

Compresión predeterminada para los datos de colección. Puede anular esta configuración individualmente al crear colecciones.

Los compresores disponibles son:

none
rápido
zlib
zstd (disponible para clústeres que ejecutan MongoDB 4.2 y versiones posteriores)

Por defecto, el compresor es snappy.

Esta configuración afecta a todas las colecciones recién creadas. Si modifica el valor de esta configuración en una implementación de MongoDB existente, todas las colecciones nuevas usarán el compresor especificado. Las colecciones existentes seguirán usando el compresor especificado al crearse o el compresor predeterminado en ese momento.

Esta configuración corresponde a la blockCompressor mongod opción de configuración del conjunto de réplicas.

wiredTiger.indexConfig. prefixCompression

booleano

Bandera que indica si se debe habilitar o deshabilitar la compresión de prefijo para los datos de índice.

Si true es, lacompresión de prefijo está habilitada para los datos de índice. Si false es, la compresión de prefijo está deshabilitada.

De forma predeterminada, wiredTiger.indexConfig.prefixCompression es true.

Esta configuración afecta a todos los índices creados. Si modifica el valor de esta configuración en una implementación de MongoDB existente, todos los índices nuevos usarán la compresión de prefijo. Los índices existentes no se ven afectados.

Esta configuración corresponde a la prefixCompression mongod opción de configuración del conjunto de réplicas.

Configuración de fragmentos

El archivo de configuración para crear o actualizar un clúster de MongoDB Cloud Manager o MongoDB Ops Manager puede contener las siguientes configuraciones para cada fragmento:

Campo	Tipo	Descripción	¿Obligatorio?
`name`	string	Nombre del fragmento.	sí
`processes`	matriz de objetos	Una matriz de objetos que contiene la configuración de cada proceso.`mongod` Cada `mongod` contiene la configuración de los miembros del conjunto de réplicas.	sí

Muestra de archivo de configuración

name: "myCluster"
version: 7.0.0
featureCompatibilityVersion: 7.0
processes:
    - hostname: host0
      dbPath: /data/cluster_2/rs1
      logPath: /data/cluster_2/rs1/mongodb.log
      priority: 1
      votes: 1
      port: 29010
    - hostname: host1
      dbPath: /data/cluster_2/rs2
      logPath: /data/cluster_2/rs2/mongodb.log
      priority: 1
      votes: 1
      port: 29020
    - hostname: host2
      dbPath: /data/cluster_2/rs3
      logPath: /data/cluster_2/rs3/mongodb.log
      priority: 1
      votes: 1
      port: 29030

{
    "name": "myCluster",
    "version": "7.0.0",
    "featureCompatibilityVersion": "7.0",
    "processes": [
     {
        "hostname": "host0",
        "dbPath": "/data/cluster_3/rs1",
        "logPath": "/data/cluster_3/rs1/mongodb.log",
        "priority": 1,
        "votes": 1,
        "port": 30010
     },
     {
        "hostname": "host1",
        "dbPath": "/data/cluster_3/rs2",
        "logPath": "/data/cluster_3/rs2/mongodb.log",
        "priority": 1,
        "votes": 1,
        "port": 30020
     },
     {
        "hostname": "host2",
        "dbPath": "/data/cluster_3/rs3",
        "logPath": "/data/cluster_3/rs3/mongodb.log",
        "priority": 1,
        "votes": 1,
        "port": 30030
     }
   ]
}

{
  "name": "myShardedCluster",
  "version": "7.0.0",
  "featureCompatibilityVersion": "7.0",
  "shards": [
    {
      "name": "myShard_0",
      "processes": [
        {
          "dbPath": "/data/myCluster/myShard_0/27000",
          "hostname": "host0.example",
          "logPath": "/data/myCluster/myShard_0/27000/mongodb.log",
          "port": 27000,
          "votes": 1
        },
        {
          "dbPath": "/data/myCluster/myShard_0/27001",
          "hostname": "host1.example",
          "logPath": "/data/myCluster/myShard_0/27001/mongodb.log",
          "port": 27001,
          "votes": 1
        },
        {
          "dbPath": "/data/myCluster/myShard_0/27002",
          "hostname": "host2.example",
          "logPath": "/data/myCluster/myShard_0/27002/mongodb.log",
          "port": 27002,
          "version": "7.0.0-ent",
          "votes": 1
        }
      ]
    },
    {
      "name": "myShard_1",
      "processes": [
        {
          "dbPath": "/data/myCluster/myShard_1/28000",
          "hostname": "host3.example",
          "logPath": "/data/myCluster/myShard_1/28000/mongodb.log",
          "port": 28000,
          "votes": 1
        },
        {
          "dbPath": "/data/myCluster/myShard_1/28001",
          "hostname": "host4.example",
          "logPath": "/data/myCluster/myShard_1/28001/mongodb.log",
          "port": 28001,
          "votes": 1
        },
        {
          "dbPath": "/data/myCluster/myShard_1/28002",
          "hostname": "host5.example",
          "logPath": "/data/myCluster/myShard_1/28002/mongodb.log",
          "port": 28002,
          "votes": 1
        }
      ]
    }
  ],
  "config": {
    "name": "configRS",
    "processes": [
      {
        "dbPath": "/data/myCluster/configRS/29000",
        "hostname": "host6.example",
        "logPath": "/data/myCluster/configRS/29000/mongodb.log",
        "port": 29000,
        "votes": 1
      },
      {
        "dbPath": "/data/myCluster/configRS/29001",
        "hostname": "host7.example",
        "logPath": "/data/myCluster/configRS/29001/mongodb.log",
        "port": 29001,
        "votes": 1
      },
      {
        "dbPath": "/data/myCluster/configRS/29002",
        "hostname": "host8.example",
        "logPath": "/data/myCluster/configRS/29002/mongodb.log",
        "port": 29002,
        "votes": 1
      }
    ]
  },
  "mongos": [
    {
      "hostname": "host9.example",
      "logPath": "/data/myCluster/mongoses/27015/mongodb.log",
      "port": 27015
    }
  ]
}

Volver

Referencia

Solución de problemas