Menu Docs
Página inicial do Docs
/
Atlas
/ /

Configurar janela de manutenção

Você pode definir a hora do dia em que o Atlas deve iniciar a manutenção semanal em seu cluster. Esta configuração é opcional e não é exigida para a maioria dos clusters. Configure as janelas de manutenção a partir das configurações do projeto.

Normalmente, você não precisa configurar manualmente uma janela de manutenção. O Atlas realiza a manutenção automaticamente de forma contínua para preservar a disponibilidade contínua de aplicativos resilientes. Você pode usar o recurso Testar Failover para garantir que seu aplicativo seja resiliente às eleições do conjunto de réplicas.

Configurar períodos de manutenção oferece mais controle sobre o agendamento da manutenção, permitindo que a manutenção que requer eleições de conjunto de réplicas ocorra no horário do dia de sua preferência, e que outras atualizações padrão ocorram fora do horário comercial crítico.

O Atlas pode realizar atividades de manutenção urgentes (como patches de segurança para vulnerabilidades de dia zero) assim que necessário, sem levar em conta os períodos de manutenção configurados ou as horas protegidas.

Depois de agendar uma janela de manutenção para o cluster, você não poderá alterá-la até que as operações de manutenção em andamento sejam concluídas.

Se a manutenção incluir uma atualização da versão de patch do MongoDB, o Atlas exibirá as versões atual e de destino no console.

O Atlas executa a manutenção da mesma forma que o procedimento de manutenção descrito no Manual do MongoDB. Esse procedimento requer pelo menos uma eleição de conjunto de réplicas durante a janela de manutenção por conjunto de réplicas.

Use o recurso Failover de teste para garantir que seu aplicativo seja resiliente às eleições do conjunto de réplicas.

A manutenção sempre começa o mais próximo possível da hora agendada, mas atualizações do cluster em andamento ou problemas inesperados do sistema podem atrasar a hora de início.

Se você tiver baixo IOPS de disco, seu cluster poderá sofrer uma breve degradação de desempenho durante a manutenção enquanto o MongoDB repreenche o mecanismo de armazenamento WiredTiger. Veja Registro no diário e o WiredTiger Storage Engine para saber mais.

Além de configurar um período de manutenção, você pode definir horas diárias protegidas, que é um período de tempo durante o qual o Atlas evita realizar atualizações padrão.

O Atlas realiza automaticamente a manutenção durante o período de manutenção. No entanto, o Atlas pode realizar atualizações padrão que não exigem uma reinicialização do cluster nem impactam o desempenho da carga de trabalho, fora do período de manutenção. Quando você ativa as horas protegidas, o Atlas realiza atualizações padrão fora do período de horas protegidas.

O comprimento da sua janela de horas protegidas não pode exceder 18 horas.

Para gerenciar períodos de manutenção, você deve ter acesso de Organization Owner ou Project Owner ao projeto.

1

Aviso

Melhorias de navegação em andamento

No momento, estamos lançando uma experiência de navegação nova e aprimorada. Se as etapas a seguir não corresponderem à sua visualização na UI do Atlas, consulte a documentação de visualização.

  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Ao lado do menu Projects, expanda o menu Options e clique em Project Settings.

    A página Configurações do projeto é exibida.

2

Para retornar os detalhes da janela de manutenção utilizando o Atlas CLI, execute o seguinte comando:

atlas maintenanceWindows describe [options]

Para atualizar a janela de manutenção utilizando o Atlas CLI, execute o seguinte comando:

atlas maintenanceWindows update [options]

Para saber mais sobre a sintaxe e os parâmetros dos comandos anteriores, consulte a documentação da CLI do Atlas para manutenção do atlasWindows e manutenção do atlasAtualização do Windows.

Dica

Veja: links relacionados

Para exibir e configurar o período de manutenção usando a IU do Atlas:

  1. Clique no botão Set Maintenance Window para exibir as configurações do período de manutenção.

  2. Defina o dia e a hora em que você deseja que o Atlas inicie a manutenção do seu projeto.

  3. Se você quiser que o Atlas adie automaticamente por uma semana qualquer manutenção programada, clique em Automatically defer maintenance for one week.

  4. Para definir um intervalo de horas protegidas em que o Atlas evita executar atualizações padrão, alterne a configuração Turn on protected hours para On. Você pode definir um intervalo máximo de 18 horas por dia.

  5. Clique em Save para manter suas alterações ou clique em Cancel para descartá-las.

Se você configurou um tempo de início da janela de manutenção preferencial, você poderá limpar as configurações utilizando o Atlas CLI ou a UI do Atlas. Limpar a configuração da janela de manutenção restaura as configurações da janela de manutenção padrão.

Para limpar a janela de manutenção configurada utilizando o Atlas CLI, execute o seguinte comando:

atlas maintenanceWindows clear [options]

Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para limpar atlas maintenanceWindows.

Para limpar o período de manutenção configurada usando a interface do Atlas, alterne a configuração Set Maintenance Window para Off.

Quando a manutenção é exigida, Atlas:

  • Exibe um banner na lista de cluster do seu projeto mostrando a data e a hora em que a manutenção está programada.

  • Entre 48 e 72 horas antes da manutenção programada, envie um e-mail de notificação aos usuários com a função Project Owner e atualize a UI do Atlas para exibir a opção de adiar a manutenção por uma semana.

    Observação

    Para configurar como você recebe notificações de janela de manutenção agendada, consulte Configurar um alerta de janela de manutenção.

Para adiar a janela de manutenção utilizando o Atlas CLI, execute o seguinte comando:

atlas maintenanceWindows defer [options]

Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para adiar atlas maintenanceWindows.

Com essas informações, você pode escolher uma das três opções na interface do Atlas:

  1. Não faça nada. A manutenção ocorre durante a janela de manutenção agendada.

  2. Selecione Begin Maintenance Now. A manutenção programada começa imediatamente. Se você escolher essa opção, o Atlas solicitará que você a confirme em um modal separado.

  3. Selecione Defer Maintenance for One Week. A manutenção agendada começa durante a janela de manutenção de sua preferência, uma semana após a data e a hora agendadas para a manutenção. Se você escolher esta opção, o Atlas solicitará que você a confirmar em um modal separado.

    Observação

    Você pode adiar um único evento de manutenção do projeto até duas vezes.

Se o Atlas atualizará a versão de manutenção do MongoDB em um dos seus clusters durante a próxima janela de manutenção, o cartão do cluster exibirá a versão de manutenção do MongoDB alvo.

Captura de tela dos nós elegíveis em três regiões
clique para ampliar

Voltar

Atualizar a versão principal do MongoDB para um cluster

Nesta página