You can upgrade the major version of your Atlas cluster at any time by modifying the cluster.
Para garantizar que la transición a la nueva versión de MongoDB sea fluida y no afecte la aplicación, antes de actualizar la versión principal en el clúster de producción Atlas, se debe usar el siguiente procedimiento para crear un clúster de pruebas y probar la aplicación con la nueva versión de MongoDB.
Considerations
Se aplican las siguientes consideraciones:
El clúster debe estar en buen estado antes de actualizar.
Si realizas una snapshot on-demand antes de una actualización de versión principal, espera a que la snapshot se complete antes de actualizar la versión.
Si se actualiza el clúster de versiones anteriores a MongoDB 8.0, se debe tener en cuenta el comportamiento de bloqueo de escritura en Atlas. Para garantizar que las escrituras del nodo primario del clúster dedicado no se bloqueen tan pronto como se actualice a MongoDB 8.0:
Se debe comprobar que el clúster tenga suficiente capacidad de almacenamiento para gestionar la carga de trabajo tras la actualización.
Se debe activar el escalado automático del almacenamiento, que escala automáticamente el almacenamiento del clúster cuando la utilización del disco supera el 90% y garantiza una disponibilidad y un rendimiento coherente de la carga de trabajo.
Each major version contains some features which may not be backward-compatible with previous versions. When upgrading to a new major version, check the Release Notes for changes which may affect your applications.
Alternativamente, si se usa la Stable API, se debe garantizar que los cambios de comportamiento entre versiones de MongoDB no perjudiquen la aplicación después de una actualización.
La MongoDB Stable API abarca un subconjunto de comandos de MongoDB que las aplicaciones utilizan para leer y escribir datos, crear colecciones e índices, y realizar otras tareas comunes. La Stable API:
Permite especificar qué versión de la API de MongoDB ejecuta la aplicación y proporciona estabilidad a largo plazo de la API para las aplicaciones.
Es compatible con lanzamientos más frecuentes y actualizaciones automáticas del servidor, lo que permite que tus aplicaciones aprovechen las características lanzadas rápidamente sin riesgo de cambios incompatibles con versiones anteriores.
Limitaciones
Las siguientes limitaciones se aplican a la actualización de la versión de su clúster:
You can't upgrade to a version that is 2 versions above the pinned FCV version. If a cluster is pinned to FCV 6.0, you can only upgrade to 7.0, not 8.0+. To learn how to pin the FCV for your cluster, see Pin the FCV for Your Cluster.
Solo se puede actualizar el clúster de Atlas una versión principal a la vez. No se puede omitir ninguna versión importante al actualizar el clúster.
Después de actualizar la versión principal de MongoDB, no puedes volver a versiones anteriores a menos que hayas anclado la compatibilidad de características entre versiones del clúster antes de la actualización.
La Migración en vivo requiere que la compatibilidad de características entre versiones de los clústeres de origen y destino coincidan en sus versiones principales. Para obtener más información sobre las rutas de migración compatibles, consulta Migrar o importar datos.
Importante
Si planea utilizar la migración en vivo, NO elija Latest Version With Auto Upgrades Para sus clústeres dedicados. Esta opción actualiza automáticamente su clúster a la última versión secundaria. La migración en vivo solo admite versiones principales y no versiones secundarias, como la versión 8.2 de MongoDB.
Starting with MongoDB 6.0, the
$$SEARCH_METAaggregation variable can't be used in any subsequent stage after a$searchMetastage.Si se desea actualizar a MongoDB 6.0 desde una versión anterior y usar la variable de agregación
$$SEARCH_METAen las queries de MongoDB Search$searchMeta, se deben revisar antes de actualizar el clúster para evitar errores.
Acceso requerido
Para actualizar un clúster, debe tener el Project Owner o un rol superior para el proyecto.
Actualice su versión principal de MongoDB
Para actualizar la versión principal de MongoDB:
En Atlas, ve a la página Clusters de tu proyecto.
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 Clusters en la sección Database.
La página de clústeres se muestra.
Se debe crear un clúster de Atlas para el entorno de pruebas.
Nota
Se puede omitir este paso si ya hay un clúster de Atlas como el entorno de preparación.
Se debe hacer clic en el botón Create para abrir el modal de creación de clúster. Se debe configurar el clúster de staging para que coincida con el clúster de producción. No es necesario activar las copias de seguridad para el clúster de preparación.
Para aprender a crear un nuevo clúster, consulte Crear un clúster.
Importante
Si se selecciona un nivel de clúster más pequeño para el clúster de etapas, se debe tener en cuenta que cualquier prueba de rendimiento ejecutada puede no ser representativa del rendimiento del clúster de producción mejorado. También es posible que se necesite seleccionar un tamaño de almacenamiento mayor dependiendo de la cantidad de datos que se desee reflejar en el clúster de staging.
Actualiza el clúster de staging con los datos del clúster de producción.
Nota
Puedes omitir este paso si ya tienes un clúster de Atlas actualizado como entorno de preparación.
Si tienes copias de seguridad activadas para el clúster de producción, Restaura el snapshot más reciente y elige el clúster de preparación como destino.
Se debe apuntar la aplicación de staging al clúster de staging.
Actualice su aplicación de prueba para que apunte a su clúster de prueba. Para obtener instrucciones sobre cómo recuperar la cadena de conexión compatible con el controlador MongoDB para el clúster de prueba,consulte Conectarse a un clúster mediante bibliotecas cliente.
Se debe confirmar que la aplicación puede conectarse exitosamente al clúster de pruebas y que la aplicación funciona como se espera.
(Opcional) Actualice su aplicación a los controladores más recientes de MongoDB.
Actualizar su aplicación a los controladores MongoDB más recientes para la versión de MongoDB de su clúster le permite acceder completamente a las funciones de la nueva versión. También puede obtener un mejor rendimiento o estabilidad con las nuevas versiones de los controladores.Consulte "Conectarse a un clúster mediante bibliotecas de cliente" para obtener documentación sobre el controlador MongoDB recomendado para una versión determinada y ejemplos de conexión. Al usar la API estable, puede asegurarse de que los cambios de comportamiento entre versiones de MongoDB no afecten negativamente a su aplicación.
Si se encuentra un error después de actualizar la aplicación, se debe presentar un ticket en el Proyecto JIRA para el driver de MongoDB.
En Atlas, ve a la página Clusters de tu proyecto.
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 Clusters en la sección Database.
La página de clústeres se muestra.
Actualiza el clúster de staging a la nueva versión principal de MongoDB.
Se debe hacer clic en Edit Config y seleccionar el clúster de preparación en el menú desplegable.
Cambia la versión del clúster a la versión principal de MongoDB que desees.
Importante
No puedes degradar la versión de MongoDB de un clúster de Atlas a menos que la compatibilidad de características entre versiones del clúster haya sido fijada previamente antes de la actualización. Si deseas volver a desplegar el entorno de staging con la versión original de MongoDB, debes terminar y volver a crear el clúster.
Haz clic en Confirm & Deploy para implementar tus cambios.
Atlas comienza automáticamente a actualizar el clúster. Se debe considerar medir el tiempo que Atlas necesita para actualizar el clúster para establecer una expectativa general para la actualización del clúster de producción.
Envía un ticket de soporte si encuentras problemas específicos de la versión con el clúster de staging actualizado.
Se debe probar la aplicación contra el clúster de ensayo actualizado.
Realiza cualquier prueba de rendimiento y operativa necesaria del clúster de ensayo.
Envía un ticket de soporte si encuentras problemas específicos de la versión con el clúster de staging actualizado.
Importante
La actualización de la versión principal requiere al menos una elección de un set de réplicas. Se debe usar el clúster de ensayo como una oportunidad para probar la resiliencia de la aplicación ante una conmutación por error primaria. Se debe consultar la Prueba de conmutación por error primaria para obtener la documentación completa.
Actualice su clúster de producción a la versión de MongoDB de destino.
Una vez que se tenga seguridad del rendimiento y la operación del clúster de ensayo, se debe repetir el procedimiento para actualizar para el clúster de producción:
Se debe actualizar la aplicación de producción con drivers más recientes de MongoDB y probar que funcione con normalidad. Este paso garantiza que la aplicación sea compatible con la nueva versión de MongoDB antes de actualizar la base de datos.
Después de preparar la aplicación, se debe actualizar la versión de MongoDB en el clúster de producción. Cuando Atlas complete la actualización, se debe verificar que las aplicaciones se conecten y funcionen con normalidad.
Si encuentras problemas con el clúster de producción actualizado, presenta un ticket de soporte de alta prioridad utilizando el procedimiento en la siguiente sección.
Gestiona la compatibilidad de características entre versiones (FCV) durante las actualizaciones
Las actualizaciones de versión principal de MongoDB son compatibles tanto con las implementaciones de Atlas como con las implementaciones on-premises. La compatibilidad de funcionalidades entre versiones activa o desactiva las funcionalidades que persisten datos incompatibles con versiones anteriores de MongoDB. Puedes fijar la compatibilidad de funcionalidades entre versiones de un clúster antes de actualizar en Atlas, lo que permite revertir MongoDB a la versión anterior tras la actualización sin experimentar problemas de compatibilidad de versiones.
Advertencia
La compatibilidad de características entre versiones es una medida a corto plazo que solo persiste hasta 4 semanas después de la fecha del pin y no simula el comportamiento de las versiones binarias anteriores. Solo pospone actualizar ciertas estructuras de datos internas que permiten nuevas funciones del servidor. Cuando estés seguro de que no es necesario cambiar a la versión anterior, desbloquea la compatibilidad de características entre versiones para que coincida con la versión binaria actual.
Para obtener más información sobre cómo fijar y desafijar compatibilidad de características entre versiones para su clúster y cómo realizar una degradación de su clúster por una versión principal, consulte Degradar la versión principal de MongoDB para un clúster.
Ponte en contacto con soporte
Si tienes alguna pregunta sobre el soporte de migración más allá de lo que se cubre en esta documentación, o si encuentras un error durante la migración, abre un archivo de ticket de soporte a través de la interfaz de usuario de Atlas.
Si tiene alguna pregunta o necesita más asistencia, póngase en contacto con nuestro equipo de soporte.