Agrega miembros a un set de réplicas autogestionado

Nodos votantes máximos

Un conjunto de réplicas puede tener un máximo de siete nodos con derecho a voto. Para agregar un miembro a un set de réplicas que ya tiene siete miembros con derecho a voto, se debe agregar el miembro como miembro sin derecho a voto o remover un voto de un existing member.

script de inicio

En implementaciones de producción, puedes configurar un script de inicio para gestionar los procesos de los nodos.

Miembros existentes

Puedes utilizar estos procedimientos para agregar nuevos nodos a un set de réplicas existente.

Restaurar a antiguos miembros

Puede utilizar estos procedimientos para volver a agregar un nodo que fue eliminado.

Si los datos del nodo eliminado son relativamente recientes, el nodo se recupera y se pone al día con el resto del conjunto de réplicas.

archivos de datos

Si tienes una copia de seguridad o un snapshot de un nodo existente, puedes mover los archivos de datos (por ejemplo, el directorio dbPath) a un nuevo sistema y utilizarlos para iniciar rápidamente un nuevo nodo. Los archivos deben ser:

• Una copia válida de los archivos de datos de un nodo del mismo set de réplicas. Consulta el documento Respalda una implementación autogestionada con snapshots del sistema de archivos para obtener más información.

  Importante

  Utiliza siempre snapshots del sistema de archivos para crear una copia de un nodo del set de réplicas existente. No usen mongodump y mongorestore para crear un nuevo set de réplicas.

• Más reciente que la operación más antigua en el oplog del primario. El nuevo nodo debe poder volverse actual aplicando operaciones del registro oplog del primario.

Asociación de IP

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.

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

Prepárese el directorio de datos

Antes de agregar un nuevo nodo a un set de réplicas existente, prepara el directorio de datos del nuevo nodo usando una de las siguientes estrategias:

• Asegúrese de que el directorio de datos del nuevo nodo no contenga datos. El nuevo nodo copiará los datos de un nodo existente.

  Si un nuevo nodo está en un estado recuperando, debe salir y convertirse en secundario antes de que MongoDB pueda copiar todos los datos como parte del proceso de replicación. Este proceso lleva tiempo, pero no requiere la intervención de un administrador.

• Copie manualmente el directorio de datos de un nodo existente. El nuevo nodo se convierte en un nodo secundario y se pondrá al día con el estado actual del set de réplicas. Copiar los datos puede acortar el tiempo que tarda el nuevo nodo en estar al día.

  Asegúrese de poder copiar el directorio de datos al nuevo nodo y comenzar la replicación dentro de la ventana permitida por el oplog. De lo contrario, la nueva instancia tendrá que realizar una sincronización inicial, que vuelve a sincronizar completamente los datos, como se describe en Volver a sincronizar un nodo de un set de réplicas autogestionado.

  Utiliza rs.printReplicationInfo() para verificar el estado actual de los miembros del set de réplicas con respecto al oplog.

Para obtener información de fondo sobre los patrones de implementación de la replicación, consulte el documento Arquitecturas de implementación para sets de réplicas.

Añadir un nodo a un conjunto de réplicas existente

1. Inicie la nueva instancia mongod. Especifique el directorio de datos y el nombre del set de réplicas. El siguiente ejemplo especifica el directorio de datos /srv/mongodb/db0 y el set de réplicas rs0:

   mongod --dbpath /srv/mongodb/db0 --replSet rs0  --bind_ip localhost,<hostname(s)|ip address(es)>

   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.

   Para obtener más información sobre las opciones de configuración, consulte la página del manual mongod.

   Nota

   Opcional

   Puedes especificar el directorio de datos, el nombre del set de réplicas y la vinculación de IP en el archivo de configuración de mongod.conf, e iniciar el mongod con el siguiente comando:

   mongod --config /etc/mongod.conf

2. Conéctate al primario del set de réplicas.

   Solo se pueden añadir nodos cuando estés conectado al primario. Si no sabes cuál nodo es el primario, inicia sesión en cualquier nodo del set de réplicas y emite el comando db.hello().

3. Usa rs.add() para añadir el nuevo nodo al set de réplicas. Pase el member configuration document al método. Por ejemplo, para añadir un nodo en el host mongodb3.example.net, ejecuta el siguiente comando:

   rs.add( { host: "mongodb3.example.net:27017" } )

   Advertencia

   Antes de MongoDB 5.0, un nuevo secundario añadido aún cuenta como nodo con derecho a voto incluso aunque no pueda servir lecturas ni convertirse en primario hasta que sus datos sean coherentes. Si tienes una versión de MongoDB anterior a la 5.0 y agregas un secundario con su votes y la configuración de priority mayor a cero, esto puede llevar a una situación en la que la mayoría de los nodos con derecho a voto estén en linea pero no se pueda elegir un primario. Para evitar estas situaciones, considera añadir el nuevo arrendatario secundario, inicialmente, con priority :0 y votes :0. Después, ejecuta rs.status() para asegurar que el nodo haya pasado al estado SECONDARY. Por último, usa rs.reconfig() para actualizar su prioridad y votos.