mongosync. Ver la
documentación actual para obtener orientación actualizada sobre mongosync e instrucciones sobre cómo actualizar a la última versión.Mongosync utiliza control de versiones semántico 2.0.0Los números de versión tienen el X.Y.Z formato, donde X es la versión principal, Y es la versión secundaria y Z es la versión del parche.
MongoDB utiliza las siguientes pautas para determinar cuándo incrementar el número de versión de Mongosync:
Número mayor: El lanzamiento rompe la compatibilidad con versiones anteriores.
Número menor: La versión incluye nuevas características importantes que son compatibles con versiones anteriores.
Número de parche: Esta versión solo incluye cambios pequeños y compatibles con versiones anteriores.
Versiones actualmente admitidas
MongoDB solo admite la última versión de parche de cada versión principal. Por ejemplo, mongosync 1.9.0 es la última versión de parche de 1.9. Si utiliza una versión de mongosync sin soporte, es posible que se le solicite actualizarla para recibir soporte.
Consideraciones relacionadas con la versión
Mongosync tiene las siguientes consideraciones relacionadas con la versión:
Ciclo de vida del soporte
Las versiones principales reciben soporte durante al menos un año a partir del primer lanzamiento de esa serie.
Si una versión de Mongosync solo funciona con una versión no compatible de MongoDB Server, esa versión de Mongosync tampoco será compatible.
Versiones de parches
Solo la última versión de cada serie de lanzamientos principales recibe nuevos parches. Por ejemplo, cuando se lanza la versión 2.1.0 de Mongosync, la versión 2.0 deja de recibir parches. Al mismo tiempo, la versión 1.3 continúa recibiendo parches hasta el lanzamiento de la versión 1.4.
Actualización en vivo
Novedades en la versión 1.7.0.
A partir de mongosync 1.7.0, puede actualizar mongosync sin reiniciar las operaciones de sincronización de datos desde el principio. Solo puede actualizar en vivo a mongosync 1.7.3 o posterior desde mongosync 1.7.2 o posterior.
Después de la actualización en vivo, mongosync continúa las operaciones que estaban en curso antes de la actualización.
Para actualizar en vivo mongosync, realice estos pasos:
(Opcional) Pausar los mongosync procesos
Para pausar mongosync, ejecute pause en cada mongosync proceso en ejecución.
Puedes reanudar los procesos mongosync más tarde desde el estado en pausa, como se muestra en el paso final.
Tip
Si no desea reanudar inmediatamente las operaciones de sincronización de datos después de la actualización en vivo, considere pausar los procesos mongosync. Esto es útil si está coordinando operaciones desde varios procesos mongosync.
Descargue e instale los nuevos mongosync binarios
Para descargar e instalar los nuevos mongosync binarios, consulte descargar e instalar mongosync.
Inicializar los mongosync procesos
Para inicializar los mongosync procesos, consulte la Guía de inicio rápido. Durante la inicialización después de una actualización en vivo, mongosync actualiza los metadatos persistentes.
Reanudar los mongosync procesos
Si pausó algún mongosync proceso anteriormente en el primer paso opcional, ejecute en todos resume los mongosync procesos.
Si ya había una operación de sincronización de datos en curso antes de la actualización en vivo,mongosync es posible que no todas las nuevas funciones añadidas a la última versión sean compatibles después de la actualización. Las mejoras de rendimiento y la corrección de errores siempre son compatibles después de la actualización en vivo. Para obtener más información sobre las nuevas funciones que podrían ser compatibles después de una actualización en vivo, consulte la versión 1.7.0.
Actualización o degradación no en vivo
Si está utilizando una versión anterior mongosync no compatible con el procedimiento de actualización en vivo, o necesita degradar mongosync, realice estos pasos:
Detener todos los procesos
mongosyncque se estén ejecutando actualmente.Descarta todas las bases de datos no del sistema en el clúster de destino.
Instalar nuevos
mongosyncbinarios.Iniciar los procesos de
mongosyncusando los nuevos binarios.
Advertencia
Los nuevos procesos mongosync no reanudan ningún trabajo que pudiera estar en curso. Las operaciones de sincronización se reinician desde el principio al iniciar los nuevos procesos.
Metadatos persistentes
Durante el funcionamiento normal, mongosync crea metadatos que se almacenan en el disco de la base de datos de destino. Estos metadatos no tienen versiones y pueden cambiar en cualquier momento.
Mensajes de registro
Los formatos de los mensajes de registro no tienen versiones y pueden cambiar en cualquier momento. Esto incluye cambios en el texto del mensaje, así como la presencia, ausencia o contenido de otros campos del mensaje.
Los scripts y aplicaciones de usuario no deben depender de la salida del registro. Deben usar la API de monitorización para determinar el estado actual mongosync de.
Ejemplos
Los siguientes ejemplos ilustran los tipos de cambios que resultarían en cada tipo de actualización del número de versión.
Versiones principales
Cambios que hacen que las versiones nueva y antigua de
mongosyncproduzcan resultados diferentes en el clúster de destino para el mismo conjunto de entradas. Excepto:Corrección de errores para los casos en los que la versión anterior de
mongosyncno puede replicar datos.Cuando el comportamiento anterior está documentado explícitamente como no compatible.
Cambios en los parámetros de la CLI documentados o en las claves de configuración que hacen que
mongosyncrechace una entrada válida anteriormente. Excepto:Corrección de errores como errores de análisis o de tipo.
Aunque los parámetros de la CLI o las claves de configuración estén obsoletos, su significado documentado no cambiará. De ser necesario, se reemplazarán las entidades obsoletas por parámetros o claves nuevos.
Cambios que rompen la compatibilidad con una versión compatible de MongoDB Server.
Descartar una versión de la API REST.
mongosyncpodría descartar todos los endpoints antiguos para reemplazarlos por una nueva versión de la API. Nunca se realizarán otros cambios incompatibles con versiones anteriores en la API REST.Eliminar el soporte para una función de MongoDB Server compatible anteriormente si
mongosyncaún admite una versión de MongoDB Server que admite la función.Si
mongosyncya admite una versión principal de MongoDB Server, se realizarán cambios que requieran nuevos privilegios de acceso para continuar admitiendo esa versión de MongoDB Server.
Versiones menores
Agregar soporte para una versión de MongoDB Server que anteriormente era incompatible.
Se requieren nuevos privilegios de acceso para una versión principal de MongoDB Server que anteriormente no contaba con soporte.
Agregar soporte para tipos de colección que anteriormente no eran compatibles.
Agregar soporte para tipos de índice que anteriormente no eran compatibles.
Agregar nuevos puntos finales, nuevos campos o nuevas entradas aceptadas en la API REST.
Agregar nuevas opciones CLI documentadas.
Agregar nuevas claves de configuración o valores aceptados.
Versiones de parches
Correcciones de errores compatibles hacia atrás.
Correcciones de regresión de rendimiento.
Mejoras de rendimiento.
Cambios en las cadenas de texto de ayuda.
Cambios en las cadenas de texto de registro.
Cambios en el texto informativo en las respuestas de la API, pero no cambios en los campos de cadena de estilo enumeración como "estado".
Corrección de errores tipográficos.