Actualizar versiones de los controladores

Overview

En esta sección, puede identificar los cambios que debe realizar en su aplicación para actualizar su controlador a una nueva versión.

Antes de actualizar, realice las siguientes acciones:

• Asegúrese de que la nueva versión del controlador sea compatible con las versiones de MongoDB Server a las que se conecta su aplicación y con las versiones de Ruby en las que se ejecuta. Para ver información sobre compatibilidad, consulte Páginade compatibilidad.

• Aborde cualquier cambio importante entre la versión actual del controlador que utiliza su aplicación y la versión de actualización planificada en la sección Cambios importantes.

A partir de la versión 2.18.0, el controlador utiliza indicadores de características para gestionar cambios importantes. Esta función permite activar cambios importantes antes del lanzamiento de la siguiente versión principal.

Control de versiones

Cada versión del controlador Ruby tiene un número de versión en el formato MAJOR.MINOR.PATCHEl controlador Ruby utiliza control de versiones semántico (SemVer), lo que normalmente significa:

• Los cambios disruptivos, la activación de nuevas funcionalidades y la eliminación de funcionalidades obsoletas sólo se realizarán en lanzamientos de versiones principales.

• Se añadirán nuevas funciones mediante indicadores de características, que deben habilitarse mediante un cambio de configuración opcional. Estos indicadores de características pueden añadirse en versiones principales o secundarias.

• La funcionalidad puede marcarse como obsoleta en versiones principales o secundarias, pero no se eliminará hasta la próxima versión principal, como mínimo.

• Las versiones de parche solo contendrán correcciones no disruptivas y actualizaciones de seguridad.

Cambios radicales

Un cambio importante es una modificación en una convención o comportamiento en una versión específica del controlador que podría impedir que su aplicación funcione correctamente si no lo soluciona antes de la actualización.

Los cambios importantes de esta sección se clasifican según la versión del controlador que los introdujo. Al actualizar las versiones del controlador, tenga en cuenta todos los cambios importantes entre la versión actual y la versión de actualización.