Cambia los nombres de host en un set de réplicas autogestionado

Requisitos previos

El siguiente procedimiento lee y actualiza la colección system.replset en la base de datos local.

Si tu implementación aplica control de acceso, el usuario que realiza el procedimiento debe tener acciones de privilegio de find y update en la colección system.replset.

Para crear un rol que proporcione los privilegios necesarios:

1. Inicie sesión como un usuario con privilegios para gestionar usuarios y roles, como un usuario con el rol de userAdminAnyDatabase. El siguiente procedimiento utiliza el myUserAdmin creado en Habilitar el control de acceso en implementaciones autogestionadas.

   mongosh --port 27017 -u myUserAdmin --authenticationDatabase 'admin' -p

2. Cree un rol de usuario que proporcione los privilegios necesarios en la colección system.replset en la base de datos local:

   db.adminCommand( {
      createRole: "systemreplsetRole",
      privileges: [
         { resource: { db: "local", collection: "system.replset" }, actions: ["find","update"] }
      ],
      roles: []
   } );

3. Otorga el rol al usuario que va a realizar el procedimiento de cambio de nombre. Por ejemplo, lo siguiente asume un usuario existente "userPerformingRename" en la base de datos admin.

   use admin
   db.grantRolesToUser( "userPerformingRename", [ { role: "systemreplsetRole", db: "admin" } ] );

Procedimiento

1. Detener todos los miembros en el conjunto de réplicas.

2. Reinicia cada nodo en un puerto diferente y sin usar la opción de tiempo de ejecución --replSet. Al cambiar el número de puerto durante el mantenimiento se impide que los clientes se conecten a este host mientras ejecuta el mantenimiento. Utiliza el --dbpath habitual del nodo, que en este ejemplo es /data/db1. Utiliza un comando que se asemeje al siguiente:

   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.

   mongod --dbpath /data/db1/ --port 37017 --bind_ip localhost,<hostname(s)|ip address(es)>

   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.

3. Para cada nodo del set de réplicas, realice la siguiente secuencia de operaciones:

   1. Conecte mongosh al que se ejecuta en el nuevo puerto temporal. Por ejemplo, para un miembro que se ejecuta en el mongod puerto 37017 temporal, ejecutaría este comando:

      mongosh --port 37017

      Si se ejecuta con control de acceso, connectarse como usuario con privilegios adecuados. Ver Prerrequisitos.

      mongosh --port 37017 -u userPerformingRename --authenticationDatabase=admin  -p

   2. Edite manualmente la configuración del conjunto de réplicas. Esta configuración es el único documento de la colección system.replset en la base de datos local.

      
      

      Para cambiar los nombres de host, edita la configuración del set de réplicas para proporcionar los nuevos nombres de host y puertos para todos los miembros del set de réplicas.

      1. Cambia a la base de datos local .

         use local

      2. Cree una variable de JavaScript para el documento de configuración. Modifica el valor del _id campo para que coincida con tu set de réplicas.

         cfg = db.system.replset.findOne( { "_id": "rs0" } )

      3. Proporcione nuevos nombres de host y puertos para cada miembro del conjunto de réplicas. Modifíquelos para que coincidan con su conjunto de réplicas.

         cfg.members[0].host = "mongodb0.example.net:27017"
         cfg.members[1].host = "mongodb1.example.net:27017"
         cfg.members[2].host = "mongodb2.example.net:27017"

      4. Actualiza los nombres de host y los puertos en la colección system.replset:

         db.system.replset.updateOne( { "_id": "rs0" }, { $set: cfg } )

      5. Verificar los cambios:

         db.system.replset.find( {}, { "members.host": 1 } )

   3. Detener el proceso mongod en el nodo.

4. Tras reconfigurar todos los miembros del conjunto, inicie cada instancia de la forma habitual: utilice mongod --replSet el número de puerto habitual y la opción. Por ejemplo:

   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.

   mongod --dbpath /data/db1/ --port 27017 --replSet rs0 --bind_ip localhost,<hostname(s)|ip address(es)>

5. Conéctese a una de las mongod instancias mediante. Por mongosh ejemplo:

   mongosh --port 27017

6. Para confirmar la nueva configuración, llama a rs.conf() en mongosh.

   Su resultado debe parecerse a:

   {
       "_id" : "rs0",
       "version" : 4,
       "members" : [
           {
               "_id" : 0,
               "host" : "mongodb0.example.net:27017"
           },
           {
               "_id" : 1,
               "host" : "mongodb1.example.net:27017"
           },
           {
               "_id" : 2,
               "host" : "mongodb2.example.net:27017"
           }
       ]
   }