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, realiza las siguientes acciones:

• Asegúrese de que la nueva versión del driver sea compatible con las versiones del MongoDB Server a las que se conecta su aplicación y con las versiones de Ruby en las que se ejecuta su aplicación. Para ver información sobre la compatibilidad, consulta la Página de 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 driver utiliza banderas de características para gestionar cambios disruptivos. Esta funcionalidad te permite optar por cambios disruptivos antes del lanzamiento de la próxima versión principal.

Control de versiones

Cada versión del controlador de Ruby lleva un número de versión con el formato MAJOR.MINOR.PATCH. El controlador Ruby utiliza Versionado 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 agregará una nueva funcionalidad utilizando banderas de características, que deben habilitarse mediante un cambio de configuración de participación. Estos flags de funcionalidad pueden añadirse tanto en versiones principales como menores.

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

• Las versiones de parches solo contendrán correcciones que no sean de ruptura 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 disruptivos en esta sección se categorizan según la versión del driver que los ha introducido. Al actualizar las versiones del driver, debes abordar todos los cambios disruptivos entre la versión actual y la versión de actualización.