Puedes establecer la hora del día en que Atlas debe iniciar el mantenimiento semanal en tu clúster. Esta configuración es opcional y no se requiere para la mayoría de los clústeres. Configura periodos de mantenimiento desde tu configuración del proyecto.
Normalmente, no se necesita configurar manualmente un periodo de mantenimiento. Atlas realiza el mantenimiento automáticamente de forma continua para preservar la disponibilidad continua de aplicaciones resilientes. Puede usar la Test Failover capacidad para asegurarse de que su aplicación sea resiliente a las elecciones del set 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 superior). Para clústeres Gratuitos y clústeres Flexibles, Atlas gestiona sus periodos de mantenimiento automáticamente y no se pueden configurar manualmente.
Consideraciones sobre el periodo de mantenimiento
Actividades de mantenimiento urgente: Atlas puede realizar actividades de mantenimiento urgente (como parches de seguridad para vulnerabilidades de día cero) tan pronto como sea necesario sin tener en cuenta los periodos de mantenimiento configurados o las horas protegidas.
Operaciones de mantenimiento en curso: Una vez que programes una ventana de mantenimiento para tu clúster, no podrás cambiarla hasta que se hayan completado las operaciones de mantenimiento en curso.
Actualizaciones de la base de datos de MongoDB: Si el mantenimiento incluye una actualización de la versión de parche de MongoDB, Atlas muestra la versión actual y la versión de destino en la consola. Si Atlas actualiza la versión de mantenimiento de MongoDB en uno de sus clústeres durante la siguiente ventana de mantenimiento, la tarjeta del clúster muestra la versión de mantenimiento de MongoDB de destino.
El mantenimiento requiere elecciones de sets 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 durante la ventana de mantenimiento por conjunto de réplicas. Utilice la función de prueba de conmutación por error para garantizar que su aplicación sea resistente a las elecciones de conjuntos de réplicas.
El mantenimiento comienza lo más cerca posible del inicio de la ventana: El mantenimiento siempre comienza lo más cerca posible de la hora programada, pero la actualización de un clúster en curso o problemas inesperados del sistema podrían retrasar el tiempo de inicio.
Potencial de degradación breve del rendimiento durante el mantenimiento: Si tienes pocos Disk IOPS, tu clúster podría experimentar una breve degradación del rendimiento durante el mantenimiento mientras MongoDB repuebla el motor de almacenamiento de WiredTiger. Para aprender más, consulte Registrar en la bitácora y el motor de almacenamiento WiredTiger.
Horas protegidas: además de configurar una ventana de mantenimiento, puede establecer horas protegidas diarias, que es un período de tiempo durante el cual Atlas evita realizar 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 el reinicio de un clúster ni afectan el rendimiento de la carga de trabajo, fuera del periodo de mantenimiento. Cuando activas las horas protegidas, Atlas realiza actualizaciones estándar fuera de la ventana de horas protegidas. La duración de la ventana de horas protegidas no puede exceder 18 horas.
Tipos de operaciones de mantenimiento programado
La Scheduled Maintenance Operations El modal puede mostrar uno o más de los siguientes tipos de mantenimiento:
Mantenimiento requerido de MongoDB: operaciones de mantenimiento críticas requeridas para la salud y estabilidad del clúster.
Actualización de la versión de MongoDB: Actualizaciones a versiones de parches o lanzamientos de mantenimiento de MongoDB.
Actualización de la versión de la política del sistema operativo: actualizaciones de las políticas del sistema operativo subyacente y parches de seguridad.
Otra operación de mantenimiento: Actividades adicionales de mantenimiento requeridas para la gestión del clúster.
Rastreo de la finalización del mantenimiento
Verás un evento Maintenance window completed en tu fuente de actividad del proyecto cuando finalicen las operaciones de mantenimiento.
Activar aplazamiento automático para futuras Windows de mantenimiento
Cuando habilitas la opción Automatically defer maintenance for one week, Atlas automáticamente pospone el mantenimiento programado futuro por una semana cada vez. Esto significa que el mantenimiento se ejecuta efectivamente cada dos semanas en lugar de semanalmente, ya que la primera semana se pospone automáticamente cada vez. Si es necesario, aún puede posponer manualmente el mantenimiento una vez más.
Importante
Si activas la opción Automatically defer maintenance for one week, Atlas configura el aplazamiento automático para futuros periodos de mantenimiento. Para aplazar el mantenimiento actualmente programado, utiliza la opción Defer 1 Week tal y como se describe en la sección Aplazar Mantenimiento.
Auto-diferir permite:
Reduzca la frecuencia de mantenimiento: Configure el sistema una vez para espaciar las operaciones de mantenimiento de manera que ocurran cada dos semanas en lugar de semanalmente.
Actualizaciones por lotes: Centraliza las operaciones de mantenimiento en un único periodo de mantenimiento y reduce el número total de eventos de mantenimiento.
Pruebe primero en entornos de menor nivel: Configure el aplazamiento automático en entornos de producción y permita que el mantenimiento se ejecute semanalmente en desarrollo o pruebas. Esto le da tiempo para validar las actualizaciones antes de que lleguen a producción.
Para activar el aplazamiento automático, consulte la sección Ver y configurar el periodo de mantenimiento.
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, diríjase a la página Project Settings.
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.
Activar esta opción configura el aplazamiento automático para futuros periodos de mantenimiento. Para posponer el mantenimiento programado actualmente, utiliza el botón Defer 1 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:
Entre 48 y 72 horas (2-3 días) antes del mantenimiento programado, Atlas muestra un banner en la lista de clústeres de su proyecto que indica la fecha y la hora del mantenimiento programado. Haga clic en Show Details para ver las operaciones de mantenimiento programadas, como actualizaciones de la versión de MongoDB, actualizaciones de políticas del sistema operativo u otros tipos de mantenimiento.
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 comenzar el mantenimiento de inmediato o posponerlo 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 de inmediato:
En el banner de mantenimiento, haga clic en Show Details. Aparece una ventana modal titulada Scheduled Maintenance Operations, que muestra la fecha y hora programadas junto con los tipos de operaciones de mantenimiento planificadas.
En el modal Scheduled Maintenance Operations, haga clic en el botón Begin Now. En el modal de confirmación de Start Cluster Maintenance Now, confirma 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 del comando y los parámetros, consulta la documentación de la Atlas CLI para la actualización de conservación de Atlas.
IMPORTANTE: Para activar el mantenimiento inmediatamente, utiliza la opción --startASAP.
# Trigger immediate maintenance for the project with the ID # 5e2211c17a3e5a48f5497de3: atlas maintenanceWindows update --startASAP --projectId 5e2211c17a3e5a48f5497de3 --output json
Atlas proporciona el punto final "actualizar One periodo de mantenimiento for One Proyecto". Puedes activar el mantenimiento de inmediato pasando el campo opcional startASAP con un valor de true.
Nota
Este curl comando utiliza un token de acceso a la cuenta de servicio(OAuth) 2.0 para autenticarse en lugar de claves de API. Para obtener más información, consulte la guía de inicio rápido de la API de administración de Atlas.
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 }'
Aplazar el mantenimiento
Utilice el siguiente procedimiento para aplazar una semana el mantenimiento programado. Para aplazar automáticamente todos los mantenimientos futuros, active la función de aplazamiento automático.
Nota
Se puede aplazar un solo evento de mantenimiento de proyecto hasta dos veces.
Para aplazar el mantenimiento programado:
En el banner de mantenimiento, haga clic en Show Details. Aparece una ventana modal titulada Scheduled Maintenance Operations, que muestra la fecha y hora programadas junto con los tipos de operaciones de mantenimiento planificadas.
En el modal Scheduled Maintenance Operations, haga clic en el botón Defer 1 Week. En el modal de confirmación de Defer Maintenance to Next Week, confirma 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.