Você pode gerenciar como o Atlas implementa a manutenção para seus projetos configurando:
Horário protegido: horário crítico para os negócios durante o qual as atualizações padrão não podem ocorrer.
Maintenance Windows: A hora do dia em que o Atlas deve iniciar a manutenção semanal que exige eleições de conjunto de réplicas para clusters em um projeto.
Sequência de manutenção: a ordem em que os projetos em sua organização recebem manutenção. Você configura a sequência de manutenção em ondas rotuladas sequencialmente, de Wave 1 a Last Wave.
Você pode visualizar como o Atlas implementa a manutenção em seus projetos, considerando seu período de manutenção, horas protegidas e configuração de sequência de manutenção, usando a ferramenta Calendário de manutenção projetada.
Importante
Os períodos de manutenção, os horários protegidos e a sequência de manutenção são configurados por projeto e se aplicam apenas a cluster dedicado (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.
Recomendamos que você defina período de manutenção, horas protegidas e sequência de manutenção, embora todos sejam opcionais. O Atlas realiza a manutenção automaticamente de forma contínua para preservar a disponibilidade contínua de aplicativos resilientes. Para confirmar se seu aplicativo é resiliente às eleições de conjunto de réplicas, teste o failover no Atlas.
Considerações sobre o gerenciamento de manutenção
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.
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 ou secundária 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 o próximo período de manutenção, o cartão do cluster exibirá a versão de manutenção do MongoDB de destino.
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 o período de manutenção por conjunto de réplicas. Para confirmar se seu aplicativo é resiliente às eleições de conjunto de réplicas, teste o failover no Atlas.
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.
Sequência de manutenção padrão: o Atlas atribui automaticamente ondas de manutenção a projetos sem atribuições explícitas de ondas usando as seguintes regras:
O Atlas atribui projetos sem um período de manutenção configurado à Onda 1.
O Atlas atribui projetos com um período de manutenção configurado à Onda 2.
Avaliação da sequência de manutenção: o Atlas avalia a sequência de manutenção configurada no momento em que um evento de manutenção é emitido pela primeira vez. Se você fizer alterações na sequência de manutenção entre o início e a conclusão de um evento de manutenção em todas as ondas, o Atlas começará a usar a nova sequência de manutenção no início do próximo evento de manutenção.
Tempo entre manutenções: quando você tem a sequência de manutenção configurada, há pelo menos um intervalo de 48horas entre o momento em que o Atlas lança a manutenção para uma onda e a onda seguinte. Uma manutenção deve ser concluída para todos os projetos atribuídos a uma determinada onda antes que o Atlas prossiga para a próxima onda, começando com Wave 1.
Tipos de operação de manutenção programada
O Scheduled Maintenance Operations modal 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 secundárias do MongoDB, versões de patch 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ê tiver a sequência de manutenção configurada para projetos em uma organização, não poderá configurar a manutenção de adiamento automático para projetos nessa organização.
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 primeiro em ambientes inferiores: configure o adiamento automático em ambientes de produção e permita que a manutenção seja executada semanalmente durante o desenvolvimento ou o staging. Isso lhe dá tempo para validar as atualizações antes que elas cheguem à 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.
Configurar o Período de Manutenção e a Sequência do seu Projeto
Exibir e configurar período de manutenção e sequência
Você pode configurar o período de manutenção, os horários protegidos e a sequência de manutenção de um projeto nas configurações da sua organização ou nas configurações desse projeto.
No Atlas, vá para a página Organization Settings.
Se ainda não estiver exibido, selecione sua organização desejada no Menu Organizations na barra de navegação.
Na barra lateral, clique em Organization Settings.
A página Configurações da organização é exibida.
A seção Maintenance Window and Sequence exibe os períodos de manutenção e a sequência que você configurou para os projetos em sua organização. Para configurar as ondas de sequência de manutenção a partir das configurações da sua organização usando a IU do Atlas:
Clique em Edit sequence for all projects.
Para atribuir manualmente ondas de manutenção aos seus projetos, selecione Manual Assignment.
Use o menu suspenso ao lado de cada projeto para atribuir uma onda de manutenção.
Se você tiver tags de projeto de ambiente definidas para seus projetos, poderá usar a opção Generate sequences based on existing project tags.
O Atlas gera as seguintes atribuições com base nas tags do projeto de ambiente. Você só pode usar essas tags de projeto para atribuições de onda de manutenção.
desenvolvimento/teste: Wave 1
staging: Wave 2
produção: Última onda
O Atlas não atualiza automaticamente essas atribuições se você atualizar a tag de ambiente de um projeto.
Se você tiver Manual Assignment selecionado, também poderá configurar a sequência de manutenção de um projeto ao configurar seu período de manutenção.
Para vincular as ondas de manutenção do seu projeto às tags do projeto de ambiente, selecione Use Project Tags to auto-define sequence.
O Atlas gera as seguintes atribuições com base nas tags do projeto de ambiente. Você só pode usar essas tags de projeto para atribuições de onda de manutenção.
desenvolvimento/teste: Wave 1
staging: Wave 2
produção: Última onda
O Atlas atualiza automaticamente essas atribuições à medida que você atualiza a tag de ambiente de um projeto.
Clique em Save para manter suas alterações ou clique em Cancel para descartá-las.
Para configurar o período de manutenção de um projeto usando a IU do Atlas:
Selecione um ou mais projetos cujo período de manutenção você deseja configurar.
Para editar o período de manutenção de um único projeto, clique no ao lado do projeto para abrir a página Edit Maintenance Window.
Para editar o período de manutenção de vários projetos, clique na caixa de seleção ao lado dos projetos que deseja selecionar. Em seguida, clique em Edit Maintenance Window.
Defina o dia e a hora em que você deseja que o Atlas inicie a manutenção nos projetos selecionados.
Para definir um intervalo de horas protegidas em que o Atlas evita executar atualizações padrão, alterne a configuração Enable protected hours para On. Você pode definir um intervalo máximo de 18 horas por dia.
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.
Importante
Adiar manutenção ao usar sequência de manutenção
A manutenção de adiamento automático não está disponível para projetos com sequência de manutenção configurada.
Você só pode adiar a manutenção de projetos com uma onda de sequência de manutenção configurada se eles forem atribuídos a Last Wave. O Atlas limita esses projetos a, no máximo, um adiamento.
Para definir a sequência de manutenção, use o menu suspenso em Sequence (per project) para atribuir seu projeto ou projetos a uma onda de manutenção.
Observação
Usando tags de projeto para definir a sequência de manutenção
Se você tiver Use Project Tags to auto-define sequence selecionado nas configurações de sequência de manutenção no nível da organização, não poderá configurar manualmente a sequência de manutenção nas configurações de um projeto.
Clique em Save para manter suas alterações ou clique em Cancel para descartá-las.
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 no ícone ao lado de Project Overview.
A página Configurações do projeto é exibida.
A seção Maintenance Window and Sequence exibe o período de manutenção e a sequência que você configurou para um projeto. Para configurar as ondas de sequência de manutenção a partir das configurações de um projeto usando a IU do Atlas:
Clique no botão Edit para configurar a 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.
Para definir um intervalo de horas protegidas em que o Atlas evita executar atualizações padrão, alterne a configuração Enable protected hours para On. Você pode definir um intervalo máximo de 18 horas por dia.
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.
Importante
Adiar manutenção ao usar sequência de manutenção
A manutenção de adiamento automático não está disponível para projetos com sequência de manutenção configurada.
Você só pode adiar a manutenção de projetos com uma onda de sequência de manutenção configurada se eles forem atribuídos a Last Wave. O Atlas limita esses projetos a, no máximo, um adiamento.
Para definir a sequência de manutenção, use o menu suspenso em Sequence (per project) para atribuir seu projeto ou projetos a uma onda de manutenção.
Observação
Usando tags de projeto para definir a sequência de manutenção
Se você tiver Use Project Tags to auto-define sequence selecionado nas configurações de sequência de manutenção no nível da organização, não poderá configurar manualmente a sequência de manutenção nas configurações de um projeto.
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.
O Atlas fornece o ponto de extremidade Atualizar um período de manutenção para um projeto e o ponto de extremidade Obter um período de manutenção para um projeto.
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.
Exclua as configurações de configuração do período de manutenção
Se você tiver períodos de manutenção, horários protegidos ou sequência de manutenção configurados, poderá excluir essas configurações usando a IU do Atlas, o Atlas CLI ou o Atlas Administration API. A exclusão da configuração do período de manutenção restaura as configurações padrão do período de manutenção.
Configurações da organização
Você pode excluir todas as ondas de sequência de manutenção configuradas clicando em Delete sequence for all projects na seção Maintenance Window and Sequence.
Para excluir períodos de manutenção específicos ou atribuições de onde de sequência:
Se você tiver ondas de sequência de manutenção configuradas, clique na aba correspondente à onda do projeto cujo período de manutenção você deseja excluir.
Em Actions, clique no ícone ao lado do período de manutenção que você deseja excluir. Isso exclui o período de manutenção e a onda de sequência atribuída.
Para excluir uma onda de sequência de manutenção atribuída sem excluir o período de manutenção:
Selecione um ou mais projetos cuja onda de sequência de manutenção você deseja excluir.
Para excluir a onda de sequência de manutenção de um único projeto, clique no ao lado do projeto para abrir a página Edit Maintenance Window.
Para excluir o período de manutenção de vários projetos, clique na caixa de seleção ao lado dos projetos que você deseja selecionar. Em seguida, clique em Edit Maintenance Window.
Selecione None usando o menu suspenso em Sequence (per project).
Configurações do projeto
Para excluir o período de manutenção e a sequência configurados usando a IU do Atlas, clique no ícone na seção Maintenance Window and Sequence.
Para excluir uma onda de sequência de manutenção atribuída sem excluir o período de manutenção:
Clique em Edit na seção Maintenance Window and Sequence.
Selecione None usando o menu suspenso em Sequence (per project).
Clique em Save para manter suas alterações ou clique em Cancel para descartá-las.
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.
O Atlas fornece o ponto de extremidade Atualizar um período de manutenção para um projeto.
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.
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 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 no ícone ao lado de Project Overview.
A página Configurações do projeto é exibida.
Na seção Database na navegação à esquerda, clique em Clusters.
No banner de manutenção, clique em View Details ou View more scheduled maintenances.
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 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
Adiar manutenção com sequência de manutenção configurada
Você só pode adiar a manutenção de projetos com uma onda de sequência de manutenção configurada se eles forem atribuídos a Last Wave. O Atlas limita esses projetos a, no máximo, um adiamento.
Observação
Você pode adiar um único evento de manutenção do projeto até duas vezes.
Para adiar a manutenção programada:
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 no ícone ao lado de Project Overview.
A página Configurações do projeto é exibida.
Na seção Database na navegação à esquerda, clique em Clusters.
No banner de manutenção, clique em View Details ou View more scheduled maintenances.
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.
Ferramenta de calendário de manutenção projetada
Para visualizar quando um evento de manutenção será implementado em seus projetos, você pode usar a ferramenta Calendário de manutenção projetada. Essa ferramenta permite que você insira configurações de período de manutenção e sequência em potencial e uma data de lançamento de manutenção. Com essas configurações e data de lançamento, a ferramenta exibe a data e a hora em que o Atlas executaria a manutenção nos projetos em cada onda de sequência.
Esta ferramenta não está vinculada à sua conta Atlas. Ela não pode ler as configurações que você definiu no Atlas nem configurar as definições para seus projetos ou organizações.