Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs
Página inicial do Docs
/
Gestão
/
Tutoriais de manutenção do conjunto de réplicas
Página inicial do Docs
/
Gestão
/
Tutoriais de manutenção do conjunto de réplicas
Página inicial do Docs
/
Gestão
/
Tutoriais de manutenção do conjunto de réplicas

Realizar Manutenção em Membros do Conjunto de Réplica Autogerenciada

Visão geral

Os conjuntos de réplicas permitem que um sistema do MongoDB permaneça disponível durante a maior parte de uma janela de manutenção.

Este documento descreve o procedimento básico para realizar a manutenção de cada um dos membros de um conjunto de réplicas. Além disso, essa sequência específica se esforça para minimizar o tempo em que o primário fica indisponível e controlar o impacto em todo o sistema.

Use essas etapas como base para operações comuns de conjunto de réplicas, especialmente para procedimentos como a atualização para a versão mais recente do MongoDB.

Procedimento

Para cada membro de um conjunto de réplicas, começando com um membro secundário, execute a seguinte sequência de eventos, terminando com o principal:

  • Reinicie a instância do mongod como uma independente.

  • Execute a tarefa na instância independente.

  • Reinicie a instância do mongod como um membro do conjunto de réplica.

1

Parar um secundário.

In mongosh, shut down the mongod instance:

db.shutdownServer()
2

Reinicie o secundário como autônomo em uma porta diferente.

No prompt do shell do sistema operacional, reinicie omongod como uma instância autônoma.

Se você estiver usando um arquivo de configuração, faça as seguintes atualizações de configuração:

Por exemplo, se estiver realizando manutenção em um nó do conjunto de réplicas do servidor de shard/configuração para manutenção, o arquivo de configuração atualizado incluirá conteúdo como o exemplo a seguir:

net:
   bindIp: localhost,<hostname(s)|ip address(es)>
   port: 27218
#   port: 27018
#replication:
#   replSetName: shardA
#sharding:
#   clusterRole: shardsvr
setParameter:
   skipShardingConfigurationChecks: true
   disableLogicalSessionCacheRefresh: true

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.

Sempre inicie o mongod com o mesmo usuário, mesmo ao reiniciar um nó do conjunto de réplicas como uma instância standalone.

3

Realizar operações de manutenção no secundário.

While the member is a standalone, use mongosh to perform maintenance:

mongo --port 27218

Importante

Embora o nó seja standalone, nenhuma gravação é replicada para esse nó e as gravações para o nó não são replicadas para os outros nós do conjunto de réplicas.

Certifique-se de que todas as gravações nesse autônomo não entrem em conflito com as gravações de oplog que serão aplicadas ao membro quando ele ingressar novamente no conjunto de réplicas.

4

Reinicie mongod como um nó do conjunto de réplicas.

Depois de executar todas as tarefas de manutenção, use o seguinte procedimento para reiniciar o mongod como um nó do conjunto de réplicas em sua porta existente.

From mongosh, shut down the standalone server after completing the maintenance:

use admin
db.shutdownServer()

Reinicie a instância do mongod como um membro do conjunto de réplicas com sua configuração original; isto é, desfaça as alterações de configuração feitas ao iniciar como um independente.

Dica

Certifique-se de remover o parâmetro disableLogicalSessionCacheRefresh .

Para shard ou configurar membros do servidor, certifique-se de remover o parâmetro skipShardingConfigurationChecks.

When it has started, connect mongosh to the restarted instance.

The secondary takes time to catch up to the primary. From mongosh, use the following command to verify that the member has caught up from the RECOVERING state to the SECONDARY state.

rs.status()
5

Execute a manutenção no último primário.

  1. To perform maintenance on the primary after completing maintenance tasks on all secondaries, connect mongosh to the primary and use rs.stepDown() to step down the primary and allow one of the secondaries to be elected the new primary. Specify a 300 second waiting period to prevent the member from being elected primary again for five minutes:

    rs.stepDown(300)

    Após as etapas primárias, o conjunto de réplicas selecionará uma nova primária.

  2. Reinicie o mongod como uma instância independente, fazendo as seguintes atualizações de configuração.

Se você estiver usando um arquivo de configuração, faça as seguintes atualizações de configuração:

Por exemplo, se estiver realizando manutenção em um nó do conjunto de réplicas do servidor de shard/configuração para manutenção, o arquivo de configuração atualizado incluirá conteúdo como o exemplo a seguir:

net:
   bindIp: localhost,<hostname(s)|ip address(es)>
   port: 27218
#   port: 27018
#replication:
#   replSetName: shardA
#sharding:
#   clusterRole: shardsvr
setParameter:
   skipShardingConfigurationChecks: true
   disableLogicalSessionCacheRefresh: true

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.

  1. Execute a tarefa de manutenção no agora autônomo.

    Importante

    Embora o nó seja standalone, nenhuma gravação é replicada para esse nó e as gravações para o nó não são replicadas para os outros nós do conjunto de réplicas.

    Certifique-se de que todas as gravações nesse autônomo não entrem em conflito com as gravações de oplog que serão aplicadas ao membro quando ele ingressar novamente no conjunto de réplicas.

  2. Após executar todas as tarefas de manutenção, reinicie a instância do mongod como um membro do conjunto de réplicas com sua configuração original; isto é, desfaça as alterações de configuração feitas ao iniciar como um independente.

    Dica

    Certifique-se de remover o parâmetro disableLogicalSessionCacheRefresh .

    Para shard ou configurar membros do servidor, certifique-se de remover o parâmetro skipShardingConfigurationChecks.

Voltar
Alterar o tamanho do Oplog
Próximo
Forçar um membro a se tornar primary
Avalie esta página

Nesta página