Alterar nomes de host em um conjunto de réplicas autogerenciado

Pré-requisitos

O procedimento a seguir lê e atualiza a coleção system.replset no banco de dados local.

Se a sua implementação impõe controle de acesso, o usuário que executa o procedimento deve ter ações de privilégio find e update na coleção system.replset.

Para criar uma função que forneça os privilégios necessários:

1. Faça login como um usuário com privilégios para gerenciar usuários e funções, como um usuário com a função userAdminAnyDatabase . O procedimento a seguir usa o myUserAdmin criado em Habilitar controle de acesso em implementações autogerenciadas.

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

2. Crie uma função de usuário que forneça os privilégios necessários na coleção do system.replset no banco de dados do local:

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

3. Conceda a função ao usuário que executará o procedimento de renomeação. Por exemplo, o seguinte pressupõe um usuário existente "userPerformingRename" no banco de dados admin.

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

Procedimento

1. Pare todos os nós no conjunto de réplicas.

2. Reinicie cada nó em uma porta diferente e sem utilizar a opção de tempo de execução do --replSet. Alterar o número da porta durante a manutenção impede que os clientes se conectem a esse host enquanto você executa a manutenção. Utilize o --dbpath usual do nó, que neste exemplo é /data/db1. Use um comando semelhante ao seguinte:

   Aviso

   Antes de vincular a um endereço IP não localhost (por exemplo, acessível publicamente), certifique-se de proteger seu cluster contra o acesso não autorizado. Para obter uma lista completa de recomendações de segurança, consulte a Lista de verificação de segurança para implementações autogerenciadas. No mínimo, procure habilitar a autenticação e fortalecer a infraestrutura de rede.

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

   Importante

   Para evitar atualizações de configuração devido a alterações de endereço IP, use nomes de host DNS em vez de endereços IP. É particularmente importante usar um nome de host DNS em vez de um endereço IP ao configurar membros de conjunto de réplicas ou membros de cluster fragmentado.

   Use nomes de host em vez de endereços IP para configurar cluster em um horizonte de rede dividido. Começando no MongoDB 5.0, nós configurados apenas com um endereço IP falham na validação de inicialização e não são iniciados.

3. Para cada nó do conjunto de réplicas, execute a seguinte sequência de operações:

   1. Conecte o mongosh ao mongod executando na nova porta temporária. Por exemplo, para um nó executando em uma porta temporária do 37017, você iria emitir este comando:

      mongosh --port 37017

      Se estiver executando com controle de acesso, conecte-se como um usuário com privilégios apropriados. Consulte Pré-requisitos.

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

   2. Edite a configuração do conjunto de réplicas manualmente. A configuração do conjunto de réplicas é o único documento na coleção system.replset no banco de dados local.

      
      

      Para alterar os nomes de host, edite a configuração do conjunto de réplicas para fornecer os novos nomes de host e portas para todos os membros do conjunto de réplicas.

      1. Mudar para o banco de dados local.

         use local

      2. Crie uma variável JavaScript para o documento de configuração. Modifique o valor do campo _id para corresponder ao seu conjunto de réplicas.

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

      3. Forneça novos nomes de host e portas para cada membro do conjunto de réplicas. Modifique os nomes de host e as portas para que correspondam ao seu 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. Atualize os nomes de host e portas na coleção system.replset:

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

      5. Verifique as alterações:

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

   3. Pare o processo mongod no nó.

4. Depois de reconfigurar todos os nós do conjunto, inicie cada instância mongod da maneira normal: use o número de porta usual e a opção --replSet. Por exemplo:

   Aviso

   Antes de vincular a um endereço IP não localhost (por exemplo, acessível publicamente), certifique-se de proteger seu cluster contra o acesso não autorizado. Para obter uma lista completa de recomendações de segurança, consulte a Lista de verificação de segurança para implementações autogerenciadas. No mínimo, procure habilitar a autenticação e fortalecer a infraestrutura de rede.

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

5. Conecte-se a uma das instâncias do mongod utilizando o mongosh. Por exemplo:

   mongosh --port 27017

6. Para confirmar a nova configuração, chame rs.conf() em mongosh.

   Seu resultado deve ser semelhante:

   {
       "_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"
           }
       ]
   }