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.
Considerações sobre a janela de manutenção
Atividades de manutenção urgentes
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.
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 uma atualização da versão de patch 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 do início da janela
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.
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.
Acompanhar conclusão da manutenção
Você verá um evento Maintenance window completed em seu Feed de atividades do projeto quando as operações de manutenção forem concluídas.
Considerações sobre Horários Protegidos
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.
Manutenção vs. 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.
Faixa de Horários Protegidos
O comprimento da sua janela de horas protegidas não pode exceder 18 horas.
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 página Project Settings.
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.
Na barra lateral, clique em Project Settings.
A página Configurações do projeto é exibida.
Exibir e configurar janela de manutenção
Para exibir e configurar o período de manutenção usando a IU do Atlas:
Clique no botão Set Maintenance Window para exibir as configurações do período de manutenção.
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.
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.
Clique em Save para manter suas alterações ou clique em Cancel para descartá-las.
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.
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 o período de manutenção configurada usando a interface do Atlas, alterne a configuração Set Maintenance Window para Off.
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.
Responda à manutenção necessária
Quando a manutenção é necessária:
O 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, o Atlas envia um e-mail aos usuários com a função
Project Ownere atualiza a IU do Atlas para exibir a opção de iniciar a manutenção imediatamente ou de adiá-la 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.
Iniciar manutenção agora
Para iniciar a manutenção imediatamente:
Clique no banner. Uma janela modal intitulada Scheduled Maintenance Operations será exibida. Esta janela descreve o conteúdo da operação de manutenção agendada atualmente.
Clique no botão Begin Now. No modal Start Cluster Maintenance Now, confirme clicando em Yes, start my maintenance now.
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 do comando, consulte a documentação da Atlas CLI para atualizar o maintenanceWindows do Atlas.
IMPORTANTE: Para trigger a manutenção imediatamente, passe a opção --startASAP.
# Trigger immediate maintenance for the project with the ID # 5e2211c17a3e5a48f5497de3: atlas maintenanceWindows update --startASAP --projectId 5e2211c17a3e5a48f5497de3 --output json
O Atlas fornece o ponto de extremidade Atualizar um período de manutenção para um projeto. Você pode trigger a manutenção imediatamente passando o campo startASAP opcional com um valor de true.
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \ --digest --include \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --header "Content-Type: application/json" \ -X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/maintenanceWindow" \ --data ' { "startASAP": true }'
Adiar manutenção
Para adiar a manutenção programada:
Clique no banner. Uma janela modal intitulada Scheduled Maintenance Operations será exibida. Esta janela descreve o conteúdo da operação de manutenção agendada atualmente.
Clique no botão Defer 1 Week. No modal Defer Maintenance to Next Week, confirme clicando em Yes, defer maintenance until next week.
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.
O Atlas fornece o ponto de extremidade Adiar um período de manutenção para um projeto.
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.