Puede configurar la hora del día en que Atlas debe iniciar el mantenimiento semanal en su clúster. Esta configuración es opcional y no es necesaria para la mayoría de los clústeres. Configure las ventanas de mantenimiento desde su Configuración del proyecto.
Normalmente, no es necesario configurar manualmente una ventana de mantenimiento. Atlas realiza el mantenimiento automáticamente y de forma continua para garantizar la disponibilidad continua de las aplicaciones resilientes. Puede usar la función de prueba de conmutación por error para garantizar que su aplicación sea resiliente a las elecciones del conjunto de réplicas.
Configurar los periodos de mantenimiento proporciona un mayor control al permitir que el mantenimiento que requiere elecciones de sets de réplicas se realice a la hora del día que prefiera y que otras actualizaciones estándar se realicen fuera del horario crítico del negocio.
Importante
Las ventanas de mantenimiento se configuran a nivel de proyecto y se aplican solo a clústeres dedicados (M10 y superiores). Para los clústeres gratuitos y flexibles, Atlas administra sus ventanas de mantenimiento automáticamente y no se pueden configurar manualmente.
Consideraciones sobre el periodo de mantenimiento
actividades de mantenimiento urgentes
Atlas puede realizar actividades de mantenimiento urgentes (como parches de seguridad para vulnerabilidades de día cero) tan pronto como sea necesario, sin tener en cuenta los períodos de mantenimiento configurados o las horas protegidas.
Operaciones de mantenimiento continuas
Una vez que se programe un periodo de mantenimiento para el clúster, no se podrá cambiar hasta que se hayan completado todas las operaciones de mantenimiento en curso.
Actualizaciones de base de datos de MongoDB
Si el mantenimiento incluye actualizar la versión de parche de MongoDB, Atlas muestra las versiones actual y objetivo en la consola.
El mantenimiento requiere elecciones de Set de réplicas
Atlas realiza el mantenimiento de la misma manera que el procedimiento de mantenimiento descrito en el Manual de MongoDB. Este procedimiento requiere al menos una elección de conjunto de réplicas por conjunto durante la ventana de mantenimiento.
Se debe usar la capacidad de prueba de conmutación por error para garantizar que la aplicación sea resistente a las elecciones del set de réplicas.
El mantenimiento comienza lo más cerca posible del inicio del periodo de mantenimiento
El mantenimiento siempre comienza lo más cerca posible de la hora programada, pero las actualizaciones en curso del clúster o problemas inesperados del sistema podrían retrasar la hora de inicio.
Potencial de degradación breve del rendimiento durante el mantenimiento
Si se tienen bajos IOPS de disco, el clúster podría experimentar una breve degradación del rendimiento durante el mantenimiento mientras MongoDB repuebla el motor de almacenamiento WiredTiger. Consulte Registrar en la bitácora y el motor de almacenamiento WiredTiger para aprender más.
Rastreo de la finalización del mantenimiento
Verás un Maintenance window completed evento en tu feed de actividades del proyecto cuando finalicen las operaciones de mantenimiento.
Consideraciones sobre las horas protegidas
Además de configurar un periodo de mantenimiento, puede establecer horas protegidas diarias, que son un plazo de tiempo durante el cual Atlas evita realizar actualizaciones estándar.
Mantenimiento frente a actualizaciones estándar
Atlas realiza automáticamente el mantenimiento durante el periodo de mantenimiento. Sin embargo, Atlas puede realizar actualizaciones estándar que no implican un reinicio del clúster ni afectan el rendimiento de la carga de trabajo, fuera del periodo de mantenimiento. Cuando se activan las horas protegidas, Atlas realiza actualizaciones estándar fuera de las horas protegidas.
Rango de horas protegidas
La duración del plazo de horas protegidas no puede exceder las 18 horas.
Acceso requerido
Para gestionar los periodos de mantenimiento, debes tener Organization Owner o Project Owner acceso al Proyecto.
Procedimiento
Abrir la configuración del proyecto
En Atlas, vaya a la Project Settings página.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haga clic en Project Settings.
La página Configuración del proyecto se muestra.
Ver y configurar el periodo de mantenimiento
Para ver y configurar el periodo de mantenimiento usando la Interfaz de Usuario de Atlas:
Hacer clic en el botón Set Maintenance Window para mostrar la configuración del periodo de mantenimiento.
Establecer el día y la hora en que se desea que Atlas comience el mantenimiento del proyecto.
Si se desea que Atlas aplace automáticamente cualquier mantenimiento programado durante una semana, hacer clic en Automatically defer maintenance for one week.
Para establecer un rango de horas protegidas en las que Atlas evite realizar actualizaciones estándar, cambiar la configuración de Turn on protected hours a On. Se puede establecer un rango máximo de tiempo de 18 horas al día.
Hacer clic en Save para conservar los cambios o hacer clic en Cancel para descartarlos.
Para devolver los detalles del periodo de mantenimiento usando la Atlas CLI, ejecuta el siguiente comando:
atlas maintenanceWindows describe [options]
Para actualizar el periodo de mantenimiento usando el Atlas CLI, ejecuta el siguiente comando:
atlas maintenanceWindows update [options]
Para obtener más información sobre la sintaxis y los parámetros de los comandos anteriores, consulta la documentación de Atlas CLI para atlas maintenanceWindows describe y atlas maintenanceWindows actualización.
Borra tus ajustes de configuración del periodo de mantenimiento
Si configuraste una hora preferida de inicio del periodo de mantenimiento, puedes borrar la configuración usando la Atlas CLI o la Interfaz de Usuario de Atlas. Al borrar la configuración del periodo de mantenimiento, se restauran los ajustes por defecto del periodo de mantenimiento.
Para borrar el periodo de mantenimiento configurado utilizando la Interfaz de Usuario de Atlas, cambia la configuración de Set Maintenance Window a Off.
Para borrar el periodo de mantenimiento configurado usando la Atlas CLI, ejecuta el siguiente comando:
atlas maintenanceWindows clear [options]
Para aprender más sobre la sintaxis y los parámetros del comando, consulta la documentación de Atlas CLI para atlas maintenanceWindows clear.
Responde al mantenimiento requerido
Cuando se requiere mantenimiento:
Atlas muestra un banner en la lista de clústeres de su proyecto que muestra la fecha y la hora en que está programado el mantenimiento.
Entre 48 y 72 horas antes del mantenimiento programado, Atlas envía un correo electrónico a los usuarios con el rol
Project Ownery actualiza la interfaz de usuario de Atlas para mostrar la opción de iniciar el mantenimiento inmediatamente o aplazar el mantenimiento por una semana.Nota
Para configurar cómo recibe notificaciones del periodo de mantenimiento programado, consulta Configurar una alerta de periodo de mantenimiento.
Comience el mantenimiento ahora
Para comenzar el mantenimiento inmediatamente:
Haga clic en el banner. Aparecerá una ventana modal titulada Scheduled Maintenance Operations. Esta ventana describe el contenido de la operación de mantenimiento programada.
Haga clic en el botón Begin Now. En el cuadro de diálogo Start Cluster Maintenance Now, confirme haciendo clic en Yes, start my maintenance now..
Para actualizar el periodo de mantenimiento usando el Atlas CLI, ejecuta el siguiente comando:
atlas maintenanceWindows update [options]
Para obtener más información sobre la sintaxis y los parámetros del comando, consulte la documentación de la CLI de Atlas para Atlas MaintenanceWindows Update.
IMPORTANTE: Para activar el mantenimiento inmediatamente, pase la --startASAP opción.
# Trigger immediate maintenance for the project with the ID # 5e2211c17a3e5a48f5497de3: atlas maintenanceWindows update --startASAP --projectId 5e2211c17a3e5a48f5497de3 --output json
Atlas proporciona el punto final "Actualizar startASAP una ventana de mantenimiento para un proyecto". Puede activar el mantenimiento inmediatamente introduciendo el valor en el campo true opcional.
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 }'
Aplazar el mantenimiento
Nota
Se puede aplazar un solo evento de mantenimiento de proyecto hasta dos veces.
Para aplazar el mantenimiento programado:
Haga clic en el banner. Aparecerá una ventana modal titulada Scheduled Maintenance Operations. Esta ventana describe el contenido de la operación de mantenimiento programada.
Haga clic en el botón Defer 1 Week. En el cuadro de diálogo Defer Maintenance to Next Week, confirme haciendo clic en Yes, defer maintenance until next week..
Nota
Se puede aplazar un solo evento de mantenimiento de proyecto hasta dos veces.
Para aplazar el periodo de mantenimiento usando la Atlas CLI, ejecute el siguiente comando:
atlas maintenanceWindows defer [options]
Para obtener más información sobre la sintaxis y los parámetros de los comandos, consulta la documentación de la CLI de Atlas para atlas maintenanceWindows defer.
Atlas proporciona el endpoint para diferir un periodo de mantenimiento para un Proyecto.
Nota
Se puede aplazar un solo evento de mantenimiento de proyecto hasta dos veces.
Actualizaciones de versión de mantenimiento durante las Windows de mantenimiento
Si Atlas actualiza la versión de mantenimiento de MongoDB en uno de sus clústeres durante el próximo periodo de mantenimiento, la tarjeta del clúster mostrará la versión de mantenimiento de MongoDB objetivo.