rs.initiate() (método mongosh)

Descripción

rs.initiate(configuration)

Inicia una set de réplicas. Opcionalmente, el método puede recibir un argumento en forma de documento que contenga la configuración de un set de réplicas.

Importante

Método mongosh

Esta página documenta a Método mongosh. Esta no es la documentación de comandos de base de datos ni de 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 para el nuevo set de réplicas. Si no se especifica una configuración, MongoDB utiliza una configuración por defecto de set 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.0, DNS de 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

Consulta ejemplo de documento de configuración de set de réplicas para conocer los detalles del documento de configuración del set 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 instancias mongod deben haber iniciado con la opción de línea de comandos --replSet (o replication.replSetName si se utiliza un archivo de configuración) configurada en myReplSet y la opción --bind_ip (o net.bindIp si se utiliza un archivo de configuración) configurada adecuadamente para que otros nodos del set de réplicas y los clientes puedan conectarse.

Advertencia

Conecta mongosh a una de las mongod instancias y ejecuta rs.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 set de réplicas, consulta Campos de configuración de set de réplicas.

Para obtener detalles sobre la implementación de un set de réplicas, consulte Implementar un set de réplicas autogestionadas.

Tip

Tutoriales de configuración de miembros autogestionados

Volver

rs.help

rs.printReplicationInfo