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 período 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 a funcionalidade 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.
Importante
Você configura períodos de manutenção no nível do projeto e elas se aplicam somente a clusters dedicados (M10 e superior). Para clusters gratuitos e clusters flexíveis, o Atlas gerencia seus períodos de manutenção automaticamente e você não pode configurá-los manualmente.
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 um período de manutenção para o cluster, você não pode alterá-lo até que as operações de manutenção contínuas 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. 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.
A manutenção requer eleições de conjunto de réplicas: o Atlas executa a manutenção da mesma maneira 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 degradação breve do desempenho durante a manutenção: se você tiver baixos IOPS de disco, seu cluster pode sofrer uma breve degradação de desempenho durante a manutenção enquanto o MongoDB repovoa o mecanismo de armazenamento WiredTiger. Para saber mais, consulte registro no diário e o mecanismo de armazenamento do WiredTiger.
Horas protegidas: 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.
Tipos de operação de manutenção programada
O modal Scheduled Maintenance Operations pode exibir um ou mais dos seguintes tipos de manutenção:
Manutenção necessária do MongoDB: operações críticas de manutenção necessárias para a integridade e a estabilidade do cluster.
Atualização de versão do MongoDB: atualizações para versões de patch do MongoDB ou versões de manutenção.
Atualização da versão da política do sistema operacional: atualizações nas políticas subjacentes do sistema operacional e patches de segurança.
Outra operação de manutenção: atividades de manutenção adicionais necessárias para o gerenciamento de cluster.
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.
Habilitar o adiamento automático para futuras janelas de manutenção
Quando você ativa a opção Automatically defer maintenance for one week, o Atlas adia automaticamente a manutenção programada futura em uma semana a cada vez. Isso significa que a manutenção é executada efetivamente a cada duas semanas em vez de semanais, já que a primeira semana é automaticamente adiada a cada vez. Se necessário, você ainda pode atrasar a manutenção manualmente mais uma vez.
Importante
Se você habilitar a opção Automatically defer maintenance for one week, o Atlas configurará o adiamento automático para futuros períodos de manutenção. Para adiar a manutenção atualmente agendada, use a opção Defer 1 Week conforme descrito na seção Adiar manutenção.
O Auto-defer permite que você:
Reduzir a frequência de manutenção: configure o adiamento automático uma vez para escalonar as operações de manutenção para ocorrer a cada duas semanas em vez de semanais.
Atualizações em lote: consolide as operações de manutenção em um único período de manutenção e reduza o número total de eventos de manutenção.
Teste em ambientes inferiores primeiro: configure o adiamento automático em ambientes de produção e permita que a manutenção seja executada semanalmente durante o desenvolvimento ou a homologação. Com isso, você terá tempo para validar as atualizações antes que elas cheguem à fase de produção.
Para ativar o adiamento automático, consulte a seção Ver e configurar o período de manutenção.
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, vá para 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.
Habilitar esta opção configura o adiamento automático para períodos de manutenção futuras. Para adiar a manutenção programada atualmente, use o botão Defer 1 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:
Entre 48 e 72 horas (2-3 dias) antes da manutenção programada, o Atlas exibe um banner na lista de clusters do seu projeto mostrando a data e a hora em que a manutenção está agendada. Clique em Show Details para ver as operações de manutenção programadas, como atualizações de versão do MongoDB, atualizações de políticas do sistema operacional ou outros tipos de manutenção.
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 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.
Iniciar manutenção agora
Para iniciar a manutenção imediatamente:
No banner de manutenção, clique em Show Details. Uma janela modal intitulada Scheduled Maintenance Operations aparece, mostrando a data e hora agendadas, juntamente com os tipos de operações de manutenção planejadas.
No modal Scheduled Maintenance Operations, clique no botão Begin Now. No modal de confirmação 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.
Observação
Este comando curl usa um token de acesso à conta de serviço (OAuth 2.0) para autenticar em vez de chaves API. Para saber mais, consulte Introdução à Atlas Administration API.
curl --header "Authorization: Bearer {ACCESS-TOKEN}" \ --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
Use o seguinte procedimento para adiar a manutenção agendada atualmente em uma semana. Para atrasar automaticamente todas as manutenções futuras, habilite adiamento automático..
Observação
Você pode adiar um único evento de manutenção do projeto até duas vezes.
Para adiar a manutenção programada:
No banner de manutenção, clique em Show Details. Uma janela modal intitulada Scheduled Maintenance Operations aparece, mostrando a data e hora agendadas, juntamente com os tipos de operações de manutenção planejadas.
No modal Scheduled Maintenance Operations, clique no botão Defer 1 Week. No modal de confirmação Defer Maintenance to Next Week, confirme clicando em Yes, defer maintenance until next week..
Observação
Você pode adiar um único evento de manutenção do projeto até duas vezes.
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.