Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Versiones de MongoDB y rutas de actualización

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.

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.

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.

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.

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.

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.

Los candidatos de lanzamiento son compilar previas al lanzamiento destinadas a evaluar la nueva funcionalidad. No son aptos para implementaciones de producció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.

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.

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.

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.

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 una versión principal de MongoDB, le recomendamos que realice las siguientes acciones, independientemente del tipo de actualización que elija:

1

Cada versión principal documenta los cambios que pueden afectar a las aplicaciones escritas para versiones anteriores.

2

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.

3

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.

Nota

No se pueden degradar los clústeres Free y Flex.