Configurar janela de manutenção
Nesta página
Você pode configurar a hora do dia em que o Atlas deve iniciar a manutenção semanal no 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 constante para preservar a disponibilidade contínua, com exceção de uma seleção momentânea de conjuntos de réplicas. Você pode usar o recurso Testar Failover para garantir que seu aplicativo seja resiliente às eleições do conjunto de réplicas.
As janelas de manutenção personalizadas fornecem maior controle sobre o desempenho do cluster, permitindo que a manutenção ocorra no horário do dia de sua preferência.
Considerações sobre a janela de manutenção
Atividades de manutenção urgentes
O Atlas executa atividades de manutenção urgentes, como patches de segurança, assim que eles são necessários, sem levar em conta as janelas de manutenção programadas.
Observação
Algumas atualizações não urgentes que não exigem uma reinicialização do mongod
, por exemplo, atualizações de serviços de backend, também podem ocorrer sem considerar a manutenção agendada do Windows.
Operações de manutenção contínuas
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.
Atualizações do Banco de Dados do MongoDB
Se a manutenção incluir a atualização das versões do MongoDB, o Atlas exibirá as versões atual e de destino no console.
A manutenção requer eleição do conjunto de réplicas
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 começa o mais próximo possível da hora
A manutenção sempre começa o mais próximo possível da hora programada, mas atualizações de cluster em andamento ou problemas inesperados do sistema podem atrasar a hora de início.
Potencial para uma breve degradação de desempenho durante a manutenção
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.
Acesso necessário
Para gerenciar janelas de manutenção, você deve ter acesso Organization Owner
ou Project Owner
ao projeto.
Procedimento
Abra as configurações do seu projeto
No Atlas, acesse a Project Settings página.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Ao lado do menu Projects, expanda o menu Options e clique em Project Settings.
A página Configurações do projeto é exibida.
Exibir e configurar janela de manutenção
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.
Para exibir e configurar o período de manutenção usando a IU do Atlas:
Alterne a configuração Set Preferred Cluster Maintenance Start Time para On. A janela de manutenção é exibida.
Clique para definir o Maintenance Start Time. O Atlas exibe esse horário no fuso horário definido em seu Profile.
Defina o dia e a hora em que você deseja que o Atlas inicie a manutenção do seu projeto.
Se você quiser que o Atlas adie automaticamente por uma semana qualquer manutenção programada, clique em Automatically defer maintenance for one week.
Clique em Save para manter suas alterações ou clique em Cancel para descartá-las.
Limpe as configurações da janela de manutenção
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 Preferred Cluster Maintenance Start Time para Off.
Responda à manutenção necessária
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.
Envia um e-mail de notificação aos usuários com a função
Project Owner
entre 48 e 72 horas antes da manutenção programada.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:
Não faça nada. A manutenção ocorre durante a janela de manutenção agendada.
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.
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.
Atualizações de versão de manutenção durante janelas de manutenção
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.