Puede gestionar cómo Atlas implementa el mantenimiento para sus proyectos mediante la configuración de:
Horas protegidas: horas críticas para el negocio durante las cuales no se puede actualizar estándar.
Mantenimiento Windows: la hora del día en que Atlas debe iniciar el mantenimiento semanal que requiere elecciones de set de réplicas para los clústeres de un Proyecto.
Secuencia de mantenimiento: el orden en que los proyectos de su organización reciben mantenimiento. La secuencia de mantenimiento se configura en oleadas etiquetadas secuencialmente, de Wave 1 a Last Wave.
Puede visualizar cómo Atlas implementa el mantenimiento en sus proyectos, dado su período de mantenimiento, las horas protegidas y la configuración de la secuencia de mantenimiento, mediante la herramienta Calendario de mantenimiento proyectado.
Importante
Los periodos de mantenimiento, las horas protegidas y la secuencia de mantenimiento se configuran por Proyecto y solo se aplican a los clústeres dedicados (M10 y superior). Para los clústeres Gratuitos y los clústeres Flexibles, Atlas gestiona sus periodos de mantenimiento automáticamente y no se pueden configurar manualmente.
Recomendamos que establezca periodos de mantenimiento, horas protegidas y secuencia de mantenimiento, aunque todos son opcionales. Atlas realiza el mantenimiento automáticamente de manera continua para preservar la disponibilidad constante de aplicaciones resilientes. Para confirmar que su aplicación es resiliente a las elecciones del set de réplicas, pruebe el failover en Atlas.
Consideraciones sobre la gestión del mantenimiento
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.
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 MongoDB: Si el mantenimiento incluye una actualización menor o de parche de la versión de MongoDB, Atlas muestra las versiones actual y objetivo en la consola. Si Atlas actualiza la versión de mantenimiento de MongoDB en uno de tus clústeres durante el próximo periodo de mantenimiento, la tarjeta del clúster mostrará la versión objetivo de mantenimiento de MongoDB.
El mantenimiento requiere elecciones del 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 set de réplicas durante el periodo de mantenimiento por set de réplicas. Para confirmar que su aplicación es resistente a las elecciones del set de réplicas, pruebe el failover en Atlas.
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.
Secuencia de mantenimiento por defecto: Atlas asigna automáticamente ondas de mantenimiento a los proyectos sin asignaciones de ondas explícitas utilizando las siguientes reglas:
Atlas asigna proyectos sin un periodo de mantenimiento configurado a Wave 1.
Atlas asigna proyectos con un periodo de mantenimiento configurado a Wave 2.
Evaluación de la secuencia de mantenimiento: Atlas evalúa la secuencia de mantenimiento configurada en el momento en que se produce un evento de mantenimiento. Si realiza cambios en la secuencia de mantenimiento entre el inicio de un evento de mantenimiento y su finalización en todas las ondas, Atlas comenzará a utilizar la nueva secuencia de mantenimiento al inicio del siguiente evento de mantenimiento.
Tiempo entre mantenimientos: Cuando tienes una secuencia de mantenimiento configurada, hay al menos un intervalo de 48horas entre el momento en que Atlas implementa el mantenimiento en una ola y la siguiente. Un mantenimiento debe completarse para todos los proyectos asignados a una ola determinada antes de que Atlas pase a la siguiente ola, comenzando con Wave 1.
Tipos de operaciones de mantenimiento programado
El modal de Scheduled Maintenance Operations 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 secundarias, 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 subyacentes del sistema operativo y los 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 tiene una secuencia de mantenimiento configurada para proyectos en una organización, no puede configurar el mantenimiento de aplazamiento automático para proyectos en esa organización.
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 del mantenimiento: configure la opción de aplazamiento automático una sola vez para espaciar las operaciones de mantenimiento y que se realicen cada dos semanas en lugar de semanalmente.
Actualizaciones por lotes: Centralice las operaciones de mantenimiento en un único periodo de mantenimiento y reduzca el número total de eventos de mantenimiento.
Pruebe primero en entornos de prueba: configure el aplazamiento automático en entornos de producción y permita que el mantenimiento se ejecute semanalmente en desarrollo o preproducción. Esto te 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.
Configurar el periodo de mantenimiento y la secuencia de su proyecto
Visualización y configuración del periodo de mantenimiento y secuencia
Puede configurar el periodo de mantenimiento, las horas protegidas y la secuencia de mantenimiento de un proyecto desde la configuración de su organización o desde la configuración de ese proyecto.
En Atlas, diríjase a la página Organization Settings.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
En la barra lateral, haga clic en Organization Settings.
Se muestra la página Configuración de la organización.
La sección Maintenance Window and Sequence muestra los periodos de mantenimiento y la secuencia que ha configurado para los proyectos de su organización. Para configurar las ondas de secuencia de mantenimiento desde la configuración de su organización mediante la Interfaz de Usuario de Atlas:
Haga clic en Edit sequence for all projects.
Para asignar manualmente las ondas de mantenimiento a sus proyectos, seleccione Manual Assignment.
Utilice el menú desplegable siguiente a cada Proyecto para asignar una ola de mantenimiento.
Si tiene etiquetas de proyecto de entorno configuradas para sus proyectos, puede usar la opción Generate sequences based on existing project tags.
Atlas genera las siguientes asignaciones en función de las etiquetas del proyecto del entorno. Solo puede usar estas etiquetas de proyecto para asignaciones de ondas de mantenimiento.
desarrollo/prueba: Wave 1
preproducción: Wave 2
Producción: Last Wave
Atlas no actualiza automáticamente estas asignaciones si actualiza la etiqueta de entorno de un proyecto.
Si tiene seleccionado Manual Assignment, también puede configurar la secuencia de mantenimiento de un proyecto al configurar su periodo de mantenimiento.
Para vincular las ondas de mantenimiento de sus Proyectos a sus etiquetas de Proyecto de entorno, seleccione Use Project Tags to auto-define sequence.
Atlas genera las siguientes asignaciones en función de las etiquetas del proyecto del entorno. Solo puede usar estas etiquetas de proyecto para asignaciones de ondas de mantenimiento.
desarrollo/prueba: Wave 1
preproducción: Wave 2
Producción: Last Wave
Atlas actualiza automáticamente estas asignaciones a medida que actualiza la etiqueta de entorno de un proyecto.
Hacer clic en Save para conservar los cambios o hacer clic en Cancel para descartarlos.
Para configurar el periodo de mantenimiento de un Proyecto mediante la Interfaz de Usuario de Atlas:
Seleccione uno o más Proyectos cuyo periodo de mantenimiento desee configurar.
Para editar el periodo de mantenimiento de un solo proyecto, haga clic en junto al proyecto para abrir la página Edit Maintenance Window.
Para editar el periodo de mantenimiento de varios proyectos, haga clic en la casilla de verificación junto a los proyectos que desea seleccionar. Luego, haga clic en Edit Maintenance Window.
Establezca el día y la hora en que desea que Atlas comience el mantenimiento de los proyectos seleccionados.
Para establecer un rango de horas protegidas en las que Atlas evite realizar actualizaciones estándar, cambiar la configuración de Enable protected hours a On. Se puede establecer un rango máximo de tiempo de 18 horas al día.
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.
Importante
Mantenimiento diferido al usar la secuencia de mantenimiento
El mantenimiento de aplazamiento automático no está disponible para los proyectos con la secuencia de mantenimiento configurada.
Solo puede aplazar el mantenimiento de los proyectos con una secuencia de mantenimiento configurada si están asignados a Last Wave. Atlas limita estos proyectos a un máximo de un aplazamiento.
Para establecer la secuencia de mantenimiento, utilice el menú desplegable en Sequence (per project) para asignar su proyecto o proyectos a una ola de mantenimiento.
Nota
Uso de etiquetas de proyecto para establecer la secuencia de mantenimiento
Si tiene Use Project Tags to auto-define sequence seleccionado en la configuración de la secuencia de mantenimiento a nivel de organización, no puede configurar manualmente la secuencia de mantenimiento desde la configuración de un proyecto.
Hacer clic en Save para conservar los cambios o hacer clic en Cancel para descartarlos.
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, haz clic en el icono junto a Project Overview.
La página Configuración del proyecto se muestra.
La sección Maintenance Window and Sequence muestra el periodo de mantenimiento y la secuencia que ha configurado para un Proyecto. Para configurar las ondas de secuencia de mantenimiento desde la configuración de un Proyecto mediante la interfaz de usuario de Atlas:
Haga clic en el botón Edit para configurar el periodo de mantenimiento o secuencia.
Establecer el día y la hora en que se desea que Atlas comience el mantenimiento del proyecto.
Para establecer un rango de horas protegidas en las que Atlas evite realizar actualizaciones estándar, cambiar la configuración de Enable protected hours a On. Se puede establecer un rango máximo de tiempo de 18 horas al día.
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.
Importante
Mantenimiento diferido al usar la secuencia de mantenimiento
El mantenimiento de aplazamiento automático no está disponible para los proyectos con la secuencia de mantenimiento configurada.
Solo puede aplazar el mantenimiento de los proyectos con una secuencia de mantenimiento configurada si están asignados a Last Wave. Atlas limita estos proyectos a un máximo de un aplazamiento.
Para establecer la secuencia de mantenimiento, utilice el menú desplegable en Sequence (per project) para asignar su proyecto o proyectos a una ola de mantenimiento.
Nota
Uso de etiquetas de proyecto para establecer la secuencia de mantenimiento
Si tiene Use Project Tags to auto-define sequence seleccionado en la configuración de la secuencia de mantenimiento a nivel de organización, no puede configurar manualmente la secuencia de mantenimiento desde la configuración de un proyecto.
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.
Atlas proporciona el endpoint para actualizar un periodo de mantenimiento para un Proyecto y el endpoint para obtener un periodo de mantenimiento para un Proyecto.
Nota
Este comando curl utiliza un token de acceso de cuenta de servicio (OAuth 2.0) para autenticar en lugar de claves API. Para obtener más información, consulte Introducción a la API de administración de Atlas.
Borrar la configuración de su periodo de mantenimiento
Si tiene periodos de mantenimiento, horas protegidas o secuencias de mantenimiento configurados, puede borrar esta configuración mediante la interfaz de usuario de Atlas, Atlas CLI o Atlas Administration API. Al borrar la configuración del periodo de mantenimiento, se restauran los ajustes por defecto del periodo de mantenimiento.
Configuraciones de la Organización
Puede borrar todas las ondas de secuencia de mantenimiento configuradas haciendo clic en Delete sequence for all projects en la sección Maintenance Window and Sequence.
Para borrar periodos de mantenimiento específicos o asignaciones de ondas de secuencia:
Si tiene configuradas ondas de secuencia de mantenimiento, haga clic en la pestaña correspondiente a la onda del proyecto cuyo periodo de mantenimiento desea borrar.
En Actions, haz clic en el icono junto al periodo de mantenimiento que deseas borrar. Esto borra el periodo de mantenimiento y la ola de secuencia asignada.
Para borrar una onda de secuencia de mantenimiento asignada sin borrar el periodo de mantenimiento:
Seleccione uno o más proyectos cuya secuencia de mantenimiento desee borrar.
Para borrar la onda de secuencia de mantenimiento de un solo proyecto, haga clic en junto al proyecto para abrir la página Edit Maintenance Window.
Para borrar el periodo de mantenimiento de varios proyectos, haga clic en la casilla de verificación junto a los proyectos que desea seleccionar. Luego, haga clic en Edit Maintenance Window.
Seleccione None con el menú desplegable en Sequence (per project).
Configuración del proyecto
Para borrar el periodo de mantenimiento y la secuencia configurados mediante la Interfaz de Usuario de Atlas, haga clic en el icono de la Maintenance Window and Sequence sección.
Para borrar una onda de secuencia de mantenimiento asignada sin borrar el periodo de mantenimiento:
Haz clic en Edit de la sección Maintenance Window and Sequence.
Seleccione None con el menú desplegable en Sequence (per project).
Hacer clic en Save para conservar los cambios o hacer clic en Cancel para descartarlos.
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.
Atlas proporciona el endpoint para actualizar un periodo de mantenimiento para un Proyecto.
Nota
Este comando curl utiliza un token de acceso de cuenta de servicio (OAuth 2.0) para autenticar en lugar de claves API. Para obtener más información, consulte Introducción a la API de administración de Atlas.
Responde al mantenimiento requerido
Cuando se requiere mantenimiento:
Entre 48 y 72 horas (2 y 3 días) antes del mantenimiento programado, Atlas muestra un banner en la lista de clústeres de tu proyecto que indica la fecha y la hora en que está programado el mantenimiento. Haz clic en Show Details para ver las operaciones de mantenimiento programadas, como las actualizaciones de la versión de MongoDB, las actualizaciones de las 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.
Comenzar el mantenimiento ahora
Para comenzar el mantenimiento de inmediato:
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, haz clic en el icono junto a Project Overview.
La página Configuración del proyecto se muestra.
En la sección Database de la navegación izquierda, haga clic en Clusters.
En el banner de mantenimiento, haga clic en View Details o View more scheduled maintenances.
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 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 comando curl utiliza un token de acceso de cuenta de servicio (OAuth 2.0) para autenticar en lugar de claves API. Para obtener más información, consulte Introducción a 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
Usa el siguiente procedimiento para aplazar el mantenimiento actualmente programado una semana. Para aplazar automáticamente todo el mantenimiento futuro, activa auto-defer.
Nota
Aplazamiento del mantenimiento con la secuencia de mantenimiento configurada
Solo puede aplazar el mantenimiento de los proyectos con una secuencia de mantenimiento configurada si están asignados a Last Wave. Atlas limita estos proyectos a un máximo de un aplazamiento.
Nota
Se puede aplazar un solo evento de mantenimiento de proyecto hasta dos veces.
Para aplazar el mantenimiento programado:
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, haz clic en el icono junto a Project Overview.
La página Configuración del proyecto se muestra.
En la sección Database de la navegación izquierda, haga clic en Clusters.
En el banner de mantenimiento, haga clic en View Details o View more scheduled maintenances.
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.
Herramienta de calendario de mantenimiento proyectado
Para visualizar cuándo se implementará un evento de mantenimiento en sus proyectos, puede utilizar la herramienta Calendario de mantenimiento proyectado. Esta herramienta le permite introducir el potencial periodo de mantenimiento y la configuración de la secuencia y una fecha de lanzamiento de mantenimiento. Dada esta configuración y la fecha de lanzamiento, la herramienta muestra la fecha y la hora en que Atlas realizaría el mantenimiento de los proyectos en cada ola de secuencia.
Esta herramienta no está vinculada a su cuenta de Atlas. No puede leer la configuración que ha configurado en Atlas ni configurar la configuración de sus proyectos u organizaciones.