Para degradar su clúster de Atlas Core a la versión anterior de MongoDB, debe haber fijado la compatibilidad de características entre versiones antes de actualizar. Este tutorial describe cómo degradar su clúster de Atlas Core y cómo fijar y desanclar la compatibilidad de características entre versiones.
Para aprender qué es la compatibilidad de características entre versiones y cómo fijarlo preserva la capacidad de degradar la versión, consulte Versiones de MongoDB y rutas de actualización.
Importante
Los clústeres Atlas Infinite no admiten el control de versiones manual de MongoDB.
Solo los clústeres de Atlas Core admiten la actualización y la degradación de las versiones de MongoDB.
Los clústeres Atlas Infinite ejecutan MongoDB con Latest Version With Auto Upgrades y no admiten actualizaciones de versión manuales. Atlas gestiona automáticamente el control de versiones de los clústeres de Atlas Infinite.
Limitaciones
Las siguientes limitaciones se aplican al degradar la versión de su clúster:
Sólo puedes degradar tu clúster utilizando el procedimiento de esta página si fijaste la compatibilidad de características entre versiones antes de actualizar.
Solo se puede cambiar el clúster a una versión principal que coincida con la compatibilidad de características entre versiones anclada.
Solo puedes realizar esta acción si la compatibilidad de características entre versiones fijada es solo una versión principal inferior a la compatibilidad de características entre versiones actual y no tienes Latest Version With Auto Upgrades habilitada la.
Si su clúster utiliza la versión más reciente con actualizaciones automáticas, no puede fijar su compatibilidad de características entre versiones ni degradar la versión del clúster. Si desea dejar de usar las actualizaciones automáticas, puede hacerlo después del lanzamiento de la versión principal (
x.0.0), pero antes de la primera versión menor de ese ciclo (x.1.0).No puedes pasarte a una versión anterior después de que haya llegado al final de su vida útil. Asegúrese de que anclar ocurra antes de que la versión actual alcance el final de su vida útil.
La fijación de compatibilidad de características entre versiones solo está disponible en clústeres dedicados.
El anclaje de la compatibilidad de características entre versiones no puede prolongarse más allá de 4 semanas a partir de la fecha del pin.
Si es necesario realizar una degradación y no fijó la compatibilidad de características entre versiones antes de la actualización, puede:
Restaurar a un punto específico en el tiempo:
Si tienes activado Continuous Cloud Backup para tu clúster, puedes realizar una restauración PIT para devolver tu clúster a un estado anterior con una versión anterior de MongoDB:
Crea un nuevo clúster con la versión principal anterior.
Realiza una restauración PIT usando las instrucciones de Restaurar desde una copia de seguridad continua en la nube.
Restaurar desde una snapshot de Atlas:
Si tienes Respaldo en la nube activado sin copias de seguridad continuas en la nube, considera restaurar la última snapshot del clúster basada en la versión anterior a un nuevo clúster:
Crea un nuevo clúster con la versión principal anterior.
Restaure la última instantánea antes de la actualización de versión de MongoDB al nuevo clúster usando las instrucciones en Restaurar desde una instantánea programada o bajo demanda.
Acceso requerido
Para reducir la versión principal de un clúster, fijar la compatibilidad de características entre versiones de su clúster o quitar la fijación de la compatibilidad de características entre versiones de su clúster, debe tener el rol Project Owner o superior para el Proyecto.
Degradar el clúster a una versión principal anterior
Para degradar el clúster en una versión principal:
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.
En la sección Additional Settings del formulario de clúster, se debe seleccionar una versión principal del menú desplegable junto a Select a Version que coincida con la compatibilidad de características entre versiones del clúster.
Aparece un banner de advertencia que indica que la versión de MongoDB del clúster será degradada.
Para degradar el clúster en una versión principal utilizando la API, se debe consultar Modificar un clúster de un proyecto.
Se debe fijar la compatibilidad de características entre versiones para el clúster
Cuando su clúster tiene una compatibilidad de características entre versiones anclada, aparece un icono de chincheta junto al Version de su clúster en la parte inferior de la tarjeta del clúster. Si se pasa el cursor sobre el ícono de alfiler, aparece una ventana emergente que muestra la compatibilidad de características entre versiones y la fecha de caducidad.
Atlas unpins your cluster's FCV on the next maintenance window starting on or after the expiration date.
Si ya se ha actualizado la versión de MongoDB del clúster, Atlas actualiza la compatibilidad de características entre versiones para que coincida con su versión de MongoDB una vez que el pin caduca.
Advertencia
La compatibilidad de características entre versiones es una medida a corto plazo que solo persiste hasta por 4 semanas después de la fecha de fijación, y no simula el comportamiento de las versiones binarias anteriores. Solo pospone actualizar ciertas estructuras de datos internas que permiten nuevas funcionalidades 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 fijar la compatibilidad de características entre versiones del clúster:
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.
Establece la fecha de vencimiento.
Todas las fechas están configuradas a Timestamp en el formato de fecha y hora ISO 8601 en UTC, en el formato MM/DD/YYYY. Fije la fecha de caducidad de la compatibilidad de características entre versiones en un plazo de cuatro semanas a partir de la fecha en la que fijó la compatibilidad de características entre versiones. Cuando pase la fecha de expiración, la descripción emergente mostrará Expired XX/XX/XXXX. Su compatibilidad de características entre versiones fijada caduca automáticamente después de 4 semanas.
After the FCV pin expires, Atlas unpins your cluster's FCV on the next maintenance window starting on or after the expiration date. If you already upgraded your cluster's MongoDB version, Atlas upgrades its FCV to match its MongoDB version.
Para fijar la compatibilidad de características entre versiones de tu clúster utilizando la API de administración de Atlas, revisa Fijar compatibilidad de características entre versiones en un clúster desde un proyecto.
Desanclar la compatibilidad de características entre versiones para el clúster
Para desanclar la compatibilidad de características entre versiones del clúster:
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.
Para desanclar la compatibilidad de características entre versiones de tu clúster usando la API de administración de Atlas, consulta Desanclar compatibilidad de características entre versiones para un solo clúster de un solo Proyecto.
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.