mongosync. Ver el
documentación actual para obtener orientaciones actualizadas sobre mongosync e instrucciones sobre cómo realizar la actualización a la última versión.Mongosync utiliza Control de versiones semántico 2.0.0. Los números de versión tienen la forma X.Y.Z, donde X es la versión principal, Y es la versión secundaria y Z es la versión de parche.
MongoDB utiliza las siguientes directrices para determinar cuándo incrementar el número de versión de Mongosync:
Número principal: Esta versión rompe la compatibilidad con versiones anteriores.
Número de versión menor: La versión incluye nuevas funcionalidades importantes que son retrocompatibles.
Número de parche: Este lanzamiento solo incluye pequeñas modificaciones 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.11.0 es la última versión de parche de 1.11. Si está utilizando una versión no compatible de mongosync, es posible que se le solicite una actualización para recibir soporte.
Consideraciones relacionadas con la versión
Mongosync tiene las siguientes consideraciones relacionadas con las versiones:
Ciclo de vida de soporte
Las versiones principales son compatibles durante al menos un año desde la primera versión de esa serie.
Si una versión de Mongosync sólo funciona con una versión no soportada de MongoDB Server, esa versión de Mongosync tampoco está soportada.
Versiones de parches
Sólo la última versión de cada serie de lanzamientos principales recibe nuevos parches. Por ejemplo, cuando se lance la versión Mongosync 2.1.0, la versión 2.0 ya no recibirá actualizaciones de parches. Al mismo tiempo, la versión 1.3 seguiría recibiendo parches hasta que se lanzara la versión 1.4 .
Actualizar o degradar
Utilice los siguientes pasos para actualizar o degradar mongosync:
Detén todos los procesos de
mongosyncque se están ejecutando actualmente.Descarta todas las bases de datos no del sistema en el clúster de destino.
Instalar nuevos binarios
mongosync.Iniciar los procesos de
mongosyncusando los nuevos binarios.
Advertencia
Los nuevos procesos de mongosync no reanudan ningún trabajo que pueda haber estado en curso. Las operaciones de sincronización reinician desde el principio cuando se inician los nuevos procesos.
Metadatos persistentes
Durante la operación normal, mongosync crea metadatos que se guardan en disco en la base de datos de destino. Estos metadatos no tienen versiones y pueden cambiar en cualquier momento.
Mensajes de registro
Los formatos de 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 en el mensaje.
Los scripts y aplicaciones de los usuarios no deberían depender de la salida de logs. Los scripts y aplicaciones deben utilizar la API de supervisión para determinar el estado actual de mongosync.
Ejemplos
Los siguientes ejemplos ilustran los tipos de cambios que resultarían en cada tipo de actualización de 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 insumos. Excepto:Corrección de errores para los casos en los que la versión anterior de
mongosyncno logra replicar datos.Cuando el comportamiento anterior esté explícitamente documentado como no compatible.
Cambios en los parámetros documentados de la CLI o en las claves de configuración de modo que
mongosyncrechace entradas que antes eran válidas. Excepto:Correcciones de errores como la interpretación o errores de tipo.
Incluso si los parámetros de la CLI o las claves de configuración quedan obsoletos, el significado de los parámetros o claves de configuración documentados nunca cambiará. Si es necesario, los nuevos parámetros o claves reemplazarán las entidades antiguas que hayan quedado obsoletas.
Cambios que rompen la compatibilidad con una versión soportada de MongoDB Server.
Eliminando una versión de la API REST.
mongosyncpodría descartar todos los puntos finales antiguos en favor de una nueva versión de la API. Nunca habrá otros tipos de cambios incompatibles hacia atrás en la API REST.Eliminar el soporte para una funcionalidad previamente soportada de MongoDB Server si
mongosyncaún admite una versión de MongoDB Server que admita la funcionalidad.Si
mongosyncya es compatible con una versión principal de MongoDB Server, son necesarios cambios que requieran nuevos privilegios de acceso para seguir soportando esa versión de MongoDB Server.
Versiones menores
Agregar soporte para una versión previamente incompatible de MongoDB Server.
Requiere nuevos privilegios de acceso para una versión principal de MongoDB Server que antes no era compatible.
Añade soporte para tipos de colecciones no admitidos previamente.
Se añade soporte para tipos de índices previamente no admitidos.
Agregar nuevos terminales, nuevos campos o nuevas entradas aceptadas en la API REST.
Añadiendo nuevas opciones documentadas a la CLI.
Añadir 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 de las respuestas de la API, pero no cambios en los campos de string al estilo de enumeración, como «estado».
Correcciones de errores tipográficos.