Importante
Se debe actualizar siempre a la última versión estable de parches de la serie de versiones.
El versionado de MongoDB tiene la forma X.Y.Z donde X.Y se refiere a la serie de lanzamientos y Z al número de parche.
A partir de MongoDB 8.2, MongoDB adopta una nueva estrategia de versionado y versión para simplificar las rutas de actualización y ofrecer opciones de versionado más claras. MongoDB se publica en dos series de versiones diferentes:
Versiones principales
Versiones menores
Versiones principales
Las versiones principales se publican cada dos años y tienen un ciclo de vida de cinco años. Estas versiones introducen nuevas funciones y mejoras, y son compatibles con MongoDB Atlas y las implementaciones locales.
Versiones de ejemplo:
7.08.0
Versiones menores
Las versiones menores introducen mejoras incrementales y nuevas características dentro del ciclo de lanzamiento de una versión principal. Son tan estables como las versiones principales y son adecuadas para cargas de trabajo de producción.
A partir de MongoDB 8.2, las versiones menores también estarán disponibles para despliegues on-premises (Community y EA) para determinados casos de uso, como Search, búsqueda vectorial y capacidades mejoradas de Queryable Encryption.
Versiones de ejemplo:
8.2
Nota
Para el ciclo de lanzamiento 8.0, MongoDB 8.2 está disponible tanto para Atlas como para implementaciones on-premises. En MongoDB Atlas, 8.2 es compatible hasta la siguiente versión menor.
Ruta de actualización
Para actualizar entre versiones menores, debes actualizar secuencialmente a través de cada versión menor. No puedes omitir versiones menores. Por ejemplo, para actualizar de 8.1 a 8.3, primero debe actualizar de 8.1 a 8.2, y luego actualizar de 8.2 a 8.3.
Para actualizar desde una versión menor a la próxima versión principal, puedes:
Actualiza mediante cada versión menor a la siguiente versión mayor. Por ejemplo, para actualizar de la 8.1 a la siguiente versión principal, actualice de la 8.1 a la 8.2, luego de la 8.2 a la 8.3 y finalmente de la 8.3 a la siguiente versión principal.
Pasar a la versión principal anterior y luego actualizar a la siguiente versión principal. Por ejemplo, para actualizar de 8.1 a la siguiente versión principal, degrade de 8.1 a 8.0, y luego actualice de 8.0 a la siguiente versión principal.
Cada paso de actualización o degradación requiere tanto una actualización binaria como una compatibilidad de características entre versiones upgrade.
Opciones de versiones para MongoDB Atlas
A partir de MongoDB 8.2, están disponibles dos opciones de versiones para los clústeres dedicados de Atlas:
Versiones principales: Puedes optar por permanecer en una versión principal específica, como MongoDB 8.0. Los clústeres en las versiones principales reciben correcciones de errores y parches de seguridad. Debes actualizar manualmente los clústeres antes de su fin de vida útil (EOL). De lo contrario, Atlas actualiza automáticamente los clústeres a la última versión principal compatible después del fin de vida útil.
Última versión con actualizaciones automáticas: si configura su clúster en esta opción de lanzamiento, recibirá actualizaciones automáticas a la última versión de MongoDB disponible y habilitará nuevas funcionalidades.
Para obtener más información sobre cómo actualizar manualmente tu clúster de Atlas, consulta Actualiza un clúster a una nueva versión de MongoDB.
Importante
Si eliges el Latest Version With Auto Upgrades opción de versión y tu clúster se actualice de una versión principal a una versión secundaria, no podrá revertir a una versión principal hasta que esté disponible la próxima versión principal.
Por ejemplo, si optas por participar mientras MongoDB 8.2 es la versión más reciente, tu clúster permanecerá en la última versión menor hasta que se publique MongoDB 9.0. Solo se puede revertir a una versión principal en la ventana entre la publicación 9.0 y la primera publicación secundaria (9.1). Si pierdes esa ventana, no podrás revertirla hasta que se lance MongoDB 10.0.
Nota
No puedes elegir una opción de versión para los clústeres de los niveles Free y Flex, ya que estos clústeres se actualizan automáticamente.
Versiones de parches
Las versiones de parche se ponen a disposición según sea necesario tanto para las versiones principales como para las versiones secundarias. Las versiones de parches generalmente incluyen correcciones de errores y mejoras menores.
Versiones de ejemplo:
8.0.1(una versión de parche de una versión principal)8.2.1(una versión de parche de una versión menor)
Versiones candidatas a lanzamiento (RC)
Antes de los nuevos lanzamientos mayores y menores, se ponen a disposición candidatos de lanzamiento para pruebas tempranas. Un Release Candidate representa una versión del próximo lanzamiento que es lo suficientemente estable para usar en pruebas, pero no es adecuada para la implementación en producción.
Versiones de ejemplo:
6.0.0-rc06.0.0-rc16.1.2-rc5
Versiones de controladores
El sistema de numeración de versiones de MongoDB difiere del sistema utilizado para los MongoDB drivers.
MongoDB Shell (mongosh)
El MongoDB Shell (mongosh) se publica por separado del MongoDB Server y utiliza su propio sistema de numeración de versiones.
Database Tools
Las MongoDB Database Tools se publican por separado del MongoDB Server y emplean su propio sistema de numeración de versiones.