MongoDB lanza nuevas versiones con una periodicidad regular. La forma en que recibe esas versiones y el control que tiene sobre los tiempos depende de cómo ejecute MongoDB. Según el tipo de implementación, debe prepararse para ejecutar una nueva versión de diferentes maneras.
Esta página explica qué significan los números de versión de MongoDB, cuáles son los tipos de lanzamiento y cómo funcionan las actualizaciones en términos generales. Para los procedimientos y políticas específicos de su implementación, consulte los enlaces a lo largo del documento.
Cómo se numeran las versiones de MongoDB
Los números de versión de MongoDB tienen el formato X.Y.Z:
X es la versión principal. Un cambio aquí indica una versión que puede incluir cambios incompatibles con versiones anteriores y nueva funcionalidad que persiste los datos en formatos que las versiones anteriores no pueden leer.
Y es la versión secundaria. Las versiones secundarias ofrecen funcionalidad incremental entre las versiones principales, y la disponibilidad depende de su tipo de implementación.
Z es la versión de parche. Las versiones de parches contienen correcciones y son compatibles con versiones anteriores dentro de su serie de versiones.
driver, MongoDB Shell y la versión de MongoDB Database Tools independientemente del servidor de base de datos. El número de versión de un driver no se corresponde con el número de versión de un servidor. Para aprender qué versiones de driver funcionan con qué versiones de servidor, consulte la página de compatibilidad de su driver.
Tipos de lanzamiento
Versiones principales
Los lanzamientos principales introducen nueva funcionalidad y pueden incluir cambios incompatibles con versiones anteriores. MongoDB es compatible con versiones principales para implementaciones de Atlas y autogestionadas.
Versiones menores
Las versiones menores ofrecen funcionalidad con una cadencia más rápida entre las versiones principales. Una vez que una nueva versión menor está disponible, MongoDB deja de aplicar parches a la versión menor anterior. Para seguir recibiendo actualizaciones de seguridad y correcciones de errores, actualice a la versión de parche más reciente de la versión menor más reciente.
A partir de MongoDB 8.2, las versiones menores están disponibles para los clústeres de Atlas en Actualizaciones automáticas. También están disponibles para implementaciones autogestionadas de Enterprise Advanced y Community.
A partir de MongoDB 9.0:
Las versiones menores están disponibles para los clústeres de Atlas con actualizaciones automáticas.
Las versiones menores no están disponibles para los clúster de Atlas con actualizaciones manuales o para implementaciones autogestionadas.
Para lanzamientos de funcionalidades incrementales, consulte Lanzamientos de actualizar funcionalidades.
Nota
Las versiones menores podrían no admitir todas las funcionalidades, en particular Atlas Migración en vivo y mongosync.
Lanzamientos de actualizar funcionalidades
A partir de MongoDB 9.0, Las versiones de actualización de funcionalidad son una versión menor anual, numerada x.5, disponible para implementaciones de Atlas y autogestionadas. Los clúster de Atlas en actualizaciones manuales y las implementaciones autogestionadas pueden usar las versiones de Feature actualizar para obtener funcionalidad incremental sin esperar a la siguiente versión principal.
Las versiones de funcionalidad para actualizar tienen el mismo cronograma de fin de vida útil y la misma elegibilidad para Extended Lifecycle Support que la versión principal que amplían.
Importante
Para recibir todas las versiones secundarias en MongoDB 9.0 y posteriores, configure su clúster de Atlas en Latest Version With Auto Upgrades. Todas las demás implementaciones solo son elegibles para la versión para actualizar funcionalidad, no para otras versiones secundarias.
Versiones de parches
Las versiones de parche contienen correcciones y son compatibles con versiones anteriores solo dentro de su propia serie de versiones principales y secundarias. Siempre debe ejecutar la última versión de parche para su versión mayor y menor.
Candidatos a lanzamiento
Los candidatos de lanzamiento son compilar previas al lanzamiento destinadas a evaluar la nueva funcionalidad. No son aptos para implementaciones de producción.
Cómo las versiones llegan a su implementación
Los lanzamientos de MongoDB llegan a Atlas antes de que estén disponibles para implementaciones autogestionadas.
Nota
Los clústeres Free y Flex permanecen en una versión principal. No puede elegir una cadencia de lanzamiento y Atlas los actualiza automáticamente.
Atlas utiliza dos métodos distintos para ofrecer actualizaciones a sus implementación: Actualizaciones manuales en Atlas y Actualizaciones automáticas en Atlas.
Actualizaciones manuales en Atlas: Usted controla cuándo actualizar a una nueva versión principal.
- Clúster de Atlas Core: puede elegir una versión principal específica y controlar cuándo actualizar a ella.
Actualizaciones automáticas en Atlas: Atlas ofrece nuevas versiones automáticamente.
Clústeres de Atlas Infinite: Los clústeres de Atlas Infinite siempre utilizan las actualizaciones automáticas. Para los clústeres de Atlas Infinite, la opción Latest Version With Auto Upgrades en la Interfaz de Usuario de Atlas siempre está habilitada.
Clústeres de Atlas Core: Los clústeres de Atlas Core pueden utilizar las actualizaciones automáticas. Para habilitar este comportamiento, seleccione la opción Latest Version With Auto Upgrades en la Interfaz de Usuario de Atlas.
Importante
Un clúster de Atlas con actualizaciones automáticas puede ejecutar una versión antes de que esa versión esté disponible para descargar e instalar por su cuenta en implementaciones autogestionadas.
Para las actualizaciones manuales de implementaciones autogestionadas (Enterprise Advanced o Community), usted elige cuándo descargar e instalar cada versión. Nada cambia hasta que usted actúa.
Compatibilidad de características entre versiones
Actualizar los binarios de MongoDB y habilitar la funcionalidad de la nueva versión son dos pasos distintos.
La compatibilidad de características entre versiones (FCV) controla si las funcionalidades que guardan datos en un formato que las versiones anteriores no pueden leer están habilitadas. Después de actualizar los binarios, su implementación continúa ejecutándose en la compatibilidad de características entre versiones anterior hasta que la eleve. Esto es deliberado, mientras la compatibilidad de características entre versiones permanezca en la versión anterior, conserva la capacidad de revertir a una versión anterior.
Nota
Para los clústeres de Atlas con actualizaciones automáticas, Atlas avanza la compatibilidad de características entre versiones (FCV) para que coincida con cada nueva versión principal de MongoDB. Atlas primero ejecuta una revisión automatizada de las señales de implementación para los binarios de MongoDB. Usted no controla la compatibilidad de características entre versiones (FCV).
Aumentar la compatibilidad de características entre versiones es el punto de no retorno. Una vez que se habilitan las funcionalidades que persisten los datos en el nuevo formato, la degradación no es posible en Atlas.
Para la referencia de comandos, consulte setFeatureCompatibilityVersion en el MongoDB Manual. Para saber cómo funciona la compatibilidad de características entre versiones en Atlas, incluida la fijación de la compatibilidad de características entre versiones antes de una actualización, consulte Actualizar la versión principal de MongoDB para un clúster.
Ciclo de vida del soporte y fin de vida útil
Cada versión principal de MongoDB es compatible durante cinco años, con un período opcional de dos años de Extended Lifecycle Support (ELS) disponible para los clientes de Enterprise Advanced. Cuando una versión llega al final de su vida útil, ya no recibe correcciones, incluidas las de seguridad, y MongoDB ya no mantiene su documentación.
El manejo difiere según el tipo de implementación:
En Atlas, MongoDB envía una notificación por correo electrónico al menos seis meses antes de que la versión llegue al final de su vida útil. La notificación incluye instrucciones para actualizar sus clústeres usted mismo. Unos meses después de la notificación, Atlas deja de permitir nuevas implementaciones en esa versión. Si no ha realizado la actualización en la fecha indicada en la notificación, Atlas actualiza sus clústeres existentes a la versión de destino por defecto actual para MongoDB. Atlas realiza la actualización durante su periodo de mantenimiento configurado si tiene uno.
Importante
La versión de destino por defecto actual para MongoDB no siempre es la versión principal inmediatamente posterior.
Las implementaciones autogestionadas requieren que actualice antes del fin de vida útil.
Para ver qué versiones son compatibles actualmente con qué plataformas, consulte Plataformas compatibles con MongoDB Enterprise o Plataformas compatibles con MongoDB Community.
Elija su ruta de actualización
Si ejecuta | Cadencia de versiones | EMPIECE AQUÍ |
|---|---|---|
Actualizaciones manuales en Atlas | Usted elige cuándo pasar a la siguiente versión principal. | |
Actualizaciones automáticas en Atlas | Atlas te actualiza automáticamente. Utilice oleadas de mantenimiento para controlar el orden en todos los entornos. | |
Actualizaciones en implementaciones autogestionadas (Enterprise Advanced y Community) | Tú eliges cuándo. |
Consideraciones de actualización autogestionada
Para implementaciones autogestionadas, los procedimientos de actualización difieren según la topología. La página de actualización de cada versión enlaza con los procedimientos de clústeres autónomos, sets de réplicas y clústeres particionados.
En las versiones de MongoDB anteriores a 9.0, no se pueden omitir versiones menores. Para pasar de una versión menor a otra, actualice a través de cada una en secuencia.
Para pasar de una versión menor a la siguiente versión principal, puede:
Actualice a través de cada versión menor restante y, luego, a la siguiente versión principal.
Vuelva a la versión principal anterior y, luego, actualice a la siguiente versión principal.
Cada paso de actualización o degradación requiere tanto una actualización binaria como una actualización de la compatibilidad de características entre versiones (compatibilidad de características entre versiones).
A partir de MongoDB 9.0, Las implementaciones de Enterprise Advanced reciben solo la versión anual de actualizar funcionalidades, además de las versiones principales. Ya no hay una secuencia de versiones secundarias para omitir dentro de un ciclo de lanzamiento.
Antes de actualizar
Antes de actualizar una versión principal de MongoDB, le recomendamos que realice las siguientes acciones, independientemente del tipo de actualización que elija:
Pruebe su aplicación con la nueva versión antes de que llegue a producción.
La forma de realizar estas acciones depende de su implementación.
Autogestionado: actualice primero una implementación de no producción.
Actualizaciones manuales en Atlas: crea un clúster de preproducción que ejecute la versión de destino y realiza pruebas en él. Consulta Actualizar la versión principal de MongoDB para un clúster.
Actualizaciones automáticas en Atlas: utilice las ventanas de mantenimiento para actualizar los entornos de preproducción y producción de forma secuencial. Las oleadas de mantenimiento pueden no detener el despliegue y no le brindan un control total sobre el momento de la actualización. Para los clústeres de Atlas Core, puede cambiar a Actualizaciones manuales si necesita más tiempo para validar una versión. Para aprender más sobre las ventanas de mantenimiento, consulte Gestionar el mantenimiento del clúster.
Degradaciones
La degradación está restringida y las restricciones dependen de su implementación. Seleccione la opción que coincida con su implementación para ver las restricciones que se le aplican.
Las versiones anteriores solo se admiten entre versiones adyacentes y requieren procedimientos específicos para la configuración de su clúster.
La degradación requiere que la compatibilidad de características entre versiones no se haya elevado o se haya fijado antes de la actualización original.
Un clúster solo puede degradarse a la versión inmediatamente anterior, ya sea la versión principal anterior o la versión de actualización de funcionalidad de esa versión principal, y las degradaciones no se pueden encadenar en varias versiones.
Un clúster en un lanzamiento de funcionalidad actualizar puede bajar de versión a su propia versión principal.
Con muy pocas excepciones, una degradación recae en la última versión de parche de la versión de destino.
Después de una degradación, la funcionalidad introducida en la versión más reciente ya no está disponible, y MongoDB no admite una segunda degradación desde la nueva posición inferior.
La degradación requiere que la compatibilidad de características entre versiones no se haya elevado o se haya fijado antes de la actualización original.
Un clúster solo puede degradarse a la versión inmediatamente anterior, ya sea la versión principal anterior o la versión de actualización de funcionalidad de esa versión principal, y las degradaciones no se pueden encadenar en varias versiones.
Un clúster en un lanzamiento de funcionalidad actualizar puede bajar de versión a su propia versión principal.
Con muy pocas excepciones, una degradación recae en la última versión de parche de la versión de destino.
Después de una degradación, la funcionalidad introducida en la versión más reciente ya no está disponible, y MongoDB no admite una segunda degradación desde la nueva posición inferior.
No puede degradar ningún clúster de Atlas que utilice actualizaciones automáticas. En particular:
No se pueden degradar los clústeres de Atlas Infinite porque siempre utilizan actualizaciones automáticas.
No puede degradar los clústeres de Atlas Core que utilizan actualizaciones automáticas. Para degradar un clúster de Atlas Core, primero debe cambiar el clúster a Actualizaciones manuales. Esto solo se puede hacer en la ventana entre después de una versión principal (
x.0.0) y antes de la primera versión menor en ese ciclo (x.1.0). Para aprender más, consulte Actualizaciones automáticas en Atlas.
Nota
No se pueden degradar los clústeres Free y Flex.
Obtén más información
notas de versión para notas de versión específicas de cada versión, cambios de compatibilidad y procedimientos de actualización y degradación
Versiones de MongoDB en Atlas para ver las opciones de cadencia de lanzamiento de Atlas
MongoDB Atlas Core: descripción general y MongoDB Atlas Infinite: descripción general para aprender sobre las ediciones de la base de datos de Atlas