Iniciar um cluster fragmentado com um Config Shard

Crie o Conjunto de Réplicas do Servidor de Configuração.

Para uma implantação de produção, implemente um conjunto de réplicas de servidor de configuração definido com pelo menos três membros.

Para este tutorial, os membros do conjunto de réplicas do servidor de configuração estão associados com os seguintes hosts:

1. Inicie cada membro do conjunto de réplicas do servidor de configuração.

   Ao iniciar cada mongod, especifique as configurações do mongod utilizando um arquivo de configuração ou a linha de comando.

   Arquivo de configuração

   Linha de comando

   Se estiver usando um arquivo de configuração, defina:

   sharding:
     clusterRole: configsvr
   replication:
     replSetName: <replica set name>
   net:
     bindIp: localhost,<hostname(s)|ip address(es)>

   • sharding.clusterRole a configsvr .

   • replication.replSetName ao nome desejado do conjunto de réplicas do servidor de configuração de configuração.

   • net.bindIp opção para um dos seguintes:

     • O nome do host/endereço IP.

     • Uma lista delimitada por vírgulas de nomes de host ou endereços IP que os clientes remotos podem usar para se conectar à instância (incluindo os outros membros do conjunto de réplicas do servidor de configuração de configuração, bem como outros membros do cluster fragmentado).

     Aviso

     Antes de vincular sua instância a um endereço IP acessível publicamente, você deve proteger seu cluster contra o acesso não autorizado. Para obter uma lista completa de recomendações de segurança, consulte Lista de verificação de segurança para implantações autogerenciadas. No mínimo, considere habilitar a autenticação e fortalecer a infraestrutura de rede.

   • Configurações adicionais conforme apropriado para seu sistema, como storage.dbPath e net.port. Para mais informações sobre o arquivo de configuração, consulte opções de configuração.

   Inicie o mongod com a opção --config definida para o caminho do arquivo de configuração.

   mongod --config <path-to-config-file>

   Se utilizar as opções da linha de comando, inicie o mongod com o --configsvr, --replSet, --bind_ip e outras opções conforme apropriado para seu sistema. Por exemplo:

   mongod --configsvr --replSet <replica set name> --dbpath <path> --bind_ip localhost,<hostname(s)|ip address(es)>

   Aviso

   Antes de vincular sua instância a um endereço IP acessível publicamente, você deve proteger seu cluster contra o acesso não autorizado. Para obter uma lista completa de recomendações de segurança, consulte Lista de verificação de segurança para implantações autogerenciadas. No mínimo, considere habilitar a autenticação e fortalecer a infraestrutura de rede.

   Para obter mais informações sobre parâmetros de inicialização, consulte a página de referência do mongod.

2. Conecte o mongosh a um dos membros do servidor de configuração .

   mongosh --host <hostname> --port <port>

3. Inicie o conjunto de réplicas.

   A partir de mongosh, execute o método rs.initiate() .

   rs.initiate() pode levar um documento de configuração opcional do conjunto de réplicas. No documento de configuração do conjunto de réplicas, inclua:

   • O _id definido como o nome do conjunto de réplicas especificado na opção replication.replSetName ou --replSet.

   • O campo configsvr configurado como true para o conjunto de réplicas do servidor de configuração.

   • A array members com um documento por cada membro do conjunto de réplicas.

   Importante

   Execute rs.initiate() em apenas uma instância mongod para o conjunto de réplicas.

   rs.initiate(
     {
       _id: "myReplSet",
       configsvr: true,
       members: [
         { _id : 0, host : "cfg1.example.net:27019" },
         { _id : 1, host : "cfg2.example.net:27019" },
         { _id : 2, host : "cfg3.example.net:27019" }
       ]
     }
   )

   Consulte Configuração do conjunto de réplicas autogerenciadas para mais informações sobre documentos de configuração do conjunto de réplicas.

Inicie um mongos para o cluster fragmentado.

Inicie um mongos utilizando um arquivo de configuração ou um parâmetro da linha de comando para especificar os servidores de configuração.

sharding:
  configDB: <configReplSetName>/cfg1.example.net:27019,cfg2.example.net:27019
net:
  bindIp: localhost,<hostname(s)|ip address(es)>

mongos --config <path-to-config>

mongos --configdb <configReplSetName>/cfg1.example.net:27019,cfg2.example.net:27019,cfg3.example.net:27019 --bind_ip localhost,<hostname(s)|ip address(es)>

Neste ponto, seu cluster fragmentado consiste no mongos e nos servidores de configuração. Agora você pode se conectar ao cluster fragmentado usando mongosh.

Conecte-se ao cluster fragmentado.

Conecte mongosh ao mongos. Especifique host e port em que mongos está sendo executado:

mongosh --host <hostname> --port <port>

Transição de um servidor de configuração dedicado para um fragmento de configuração.

Este exemplo configura um servidor de configuração dedicado para ser executado como um shard de configuração:

db.adminCommand( {
   transitionFromDedicatedConfigServer: 1
} )

Confirme se o cluster usa um shard de configuração

Para confirmar que o cluster fragmentado agora usa o shard de configuração, execute o comando serverStatus para verificar se o status configServerInShardCache retorna true:

db.adminCommand( {
   serverStatus: 1,
} ).shardingStatistics.configServerInShardCache

true