rs.initiate() (método mongosh)

Descripción

rs.initiate(configuration)

Inicia una Conjunto de réplicas. Opcionalmente, el método puede tomar un argumento en forma de documento que contiene la configuración de un conjunto de réplicas.

Importante

Método mongosh

Esta página documenta una mongosh Método. Esta no es la documentación para comandos de base de datos ni para controladores específicos del lenguaje, como Node.js.

Para el comando de base de datos, consulta el comando replSetInitiate.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

El método rs.initiate() tiene el siguiente parámetro:

Parameter	Tipo	Descripción
`configuration`	Documento	Opcional. Un documento que especifica la configuración del nuevo conjunto de réplicas. Si no se especifica ninguna configuración, MongoDB utiliza la configuración predeterminada del conjunto de réplicas.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Asociación de IP

Advertencia

Antes de vincular la instancia a una dirección IP de acceso público, se debe asegurar el clúster contra accesos no autorizados. Para obtener una lista completa de recomendaciones de seguridad, se debe consultar Checklist de seguridad para implementaciones autogestionadas. Como mínimo, se debe considerar habilitar la autenticación y reforzar la infraestructura de red.

Los binarios de MongoDB, mongod y mongos, se enlazan a localhost por defecto. Si se establece el ajuste del archivo de configuración net.ipv6 o la opción de línea de comandos --ipv6 para el binario, el binario se vincula además a la dirección IPv6 de localhost.

Por defecto, mongod y mongos que están vinculados a localhost solo aceptan conexiones de clientes que se ejecutan en el mismo ordenador. Este comportamiento de vinculación incluye mongosh y otros nodos del set de réplicas o clúster. Los clientes remotos no pueden conectarse a binarios que están vinculados únicamente a localhost.

Para anular la vinculación por defecto y enlazar a otras direcciones IP, utiliza la configuración del archivo de configuración net.bindIp o la opción de línea de comandos --bind_ip para especificar una lista de nombres de host o direcciones IP.

Advertencia

A partir de MongDB,5.0DNSde horizonte divididoLos nodos configurados únicamente con una dirección IP no superan la validación de inicio y reportan un error.disableSplitHorizonIPCheck Consulte.

Por ejemplo, la siguiente instancia de mongod se vincula tanto al localhost como al nombre de host My-Example-Associated-Hostname, que está asociado con la dirección IP 198.51.100.1:

mongod --bind_ip localhost,My-Example-Associated-Hostname

Para conectarse a esta instancia, los clientes remotos deben especificar el nombre de host o su dirección IP asociada 198.51.100.1:

mongosh --host My-Example-Associated-Hostname
mongosh --host 198.51.100.1

Configuración del conjunto de réplicas

Consulte el Ejemplo de documento de configuración del conjunto de réplicas para obtener detalles del documento de configuración del conjunto de réplicas.

Importante

Para evitar actualizaciones de configuración debido a cambios en las direcciones IP, utilice nombres de host DNS en lugar de direcciones IP. Es particularmente importante usar un nombre de host DNS en lugar de una dirección IP al configurar miembros de set de réplicas o miembros de clústeres particionados.

Utiliza nombres de host en lugar de direcciones IP para configurar clústeres en un horizonte de red dividido. A partir de MongoDB 5.0, los nodos que solo están configurados con una dirección IP no pasan la validación de inicio y no se inician.

Ejemplo

El siguiente ejemplo inicia un nuevo conjunto de réplicas con tres miembros.

Las tres instanciasmongoddeben haber comenzado con la opción de línea de comando--replSet(oreplication.replSetNamesi se usa un archivo de configuración) establecida en myReplSet y la--bind_ip(onet.bindIpsi se usa un archivo de configuración) establecida adecuadamente para que otros miembros del conjunto de réplicas y los clientes puedan conectarse.

Advertencia

Conectemongosha una de lasmongodinstancias y ejecuters.initiate().

Nota

Ejecute rs.initiate() en una sola mongod instancia para el conjunto de réplicas.

Importante

rs.initiate(
   {
      _id: "myReplSet",
      version: 1,
      members: [
         { _id: 0, host : "mongodb0.example.net:27017" },
         { _id: 1, host : "mongodb1.example.net:27017" },
         { _id: 2, host : "mongodb2.example.net:27017" }
      ]
   }
)

Para obtener detalles sobre la configuración del conjunto de réplicas, consulte Campos de configuración del conjunto de réplicas.

Para obtener detalles sobre cómo implementar un conjunto de réplicas, consulte Implementar un conjunto de réplicas autoadministrado.

Tip

Tutoriales de configuración de miembros autogestionados

Volver

rs.ayuda

rs.printReplicationInfo