La gestión de la configuración es un área de la Ingeniería de Software cuya misión es controlar la evolución de un producto desarrollado. Involucra un conjunto de técnicas para gestionar con eficiencia los cambios que se realicen sobre ese producto a lo largo de su ciclo de vida.

El objetivo de este artículo es hacer una breve introducción general al uso estandarizado de Git en entornos colaborativos utilizando solicitudes de integración y Git como sistema controlador de versiones.

Git1

Uno de los aspectos que administra la gestión de la configuración es el control de versiones, que se puede definir como el proceso responsable de identificar y mantener registros de las diversas versiones y liberaciones de un sistema. En términos generales, cuando se habla de gestión de versiones en un proyecto de software, se refiere a la administración del código fuente.

Por suerte, para el mundo del desarrollo del software existen herramientas que ayudan a los equipos de desarrollo a manejar los cambios en el código a lo largo del ciclo de vida. Estos sistemas mantienen el registro de cada modificación realizada en un repositorio o base de datos con el objetivo de poder recuperarlas fácilmente, tratando de interrumpir lo menos posible al resto de los miembros del equipo.

El sistema más utilizado mundialmente en la actualidad es Git, que fue desarrollado en el año 2005 por Linus Torvalds (el creador del kernel de Linux) y es un proyecto open source.

Configuración de ramas del proyecto

Cuando comienza un proyecto resulta necesario realizar una configuración inicial de ramas o branches. Una rama representa una línea independiente de desarrollo que mantiene su propia historia de commits y revisiones.

Las ramas recomendadas a crear al empezar el desarrollo son:

Git2

Cada rama debería tener su propio entorno ya sea de base de datos como de configuración (propiedades de archivos properties, endpoints, datos de conexión a base de datos, etc).

También puede existir una rama denominada “Hot fix” con el objetivo de solucionar cualquier bug que haya surgido en la versión de producción y es necesario resolver inmediatamente.

Configuración de ramas de trabajo diario

Los desarrolladores que participen en el proyecto deberán crear ramas de trabajo “temporales” por cada funcionalidad o bug en el que trabajen.

Es muy común, en el caso de estar usando una herramienta de gestión de proyecto como pueden ser Jira o Trello que el nombre de la rama, se corresponda con el título de la historia de usuario, tarea o bug a resolver.

Por ejemplo, si tenemos una historia de usuario con el ID C-181 en la que se solicita: “Como usuario quiero poder ver un listado de clientes para analizar sus características”, se puede crear una nueva rama denominada “C-181-ListarClientes”. También resulta bastante común en el caso de no contar con identificadores o sistema de gestión, utilizar el prefijo f/ para funcionalidades y b/ para bugs. Por ejemplo: f/ListarClientes o b/SumaIncorrectaIVA.

Estas ramas de trabajo siempre deberán partir de la rama “Development” que hemos definido anteriormente y, una vez terminada la funcionalidad, deberán fusionarse nuevamente con ésta, agregando la nueva funcionalidad o resolución de bug. Para esta última actividad, el programador realizará lo que se llama una solicitud de integración o Pull Request.

Trabajando con Solicitudes de integración / Pull Requests

Una solicitud de integración es un mecanismo colaborativo a través del cual un desarrollador puede avisar al resto del equipo que ha completado una funcionalidad y que está apta de ser revisada por el equipo e integrada al repositorio de código. Esta acción se realiza solicitando la integración del branch utilizado para hacer la funcionalidad o corregir el bug hacia el branch sobre el cual trabaja el equipo que, según la arquitectura propuesta en este artículo, sería el de desarrollo.

Antes de realizar la solicitud, el programador debe verificar que la versión que propone subir no entra en conflicto con ningún elemento de la rama de Development. Es recomendable, entonces, realizar una acción de rebase (puede usarse también merge, pero con el objetivo de mantener un historial limpio y claro, se recomienda el uso de rebase) para integrar cualquier otra funcionalidad que se haya añadido durante el tiempo de desarrollo de la tarea.

Es importante entender que el Pull Request es mucho más que un aviso de finalización de una funcionalidad, es una oportunidad de inspección para el equipo en donde colectivamente se hace una revisión del código y se proponen mejoras en el caso que corresponda. Muchas veces los equipos usan las solicitudes de integración como mecanismo para demostrar pruebas de concepto a sus compañeros sin la necesidad de mezclar su código con el producto que se está desarrollando.

En tal caso, se pueden tratar temas como: una forma innovadora de realizar un proceso, demostrar el uso de una nueva librería, etc. Es condición necesaria que esta revisión del código se realice desde la perspectiva del respeto (fundamentalmente en equipos virtuales donde no se puede discutir la revisión cara a cara) para que ningún miembro del equipo se sienta ofendido por los comentarios.

En forma resumida, los pasos deberían ser los siguientes:

  1. Crear una rama propia de la tarea o feature a completar desde Development respetando la nomenclatura definida para el proyecto.
  2. Trabajar y completar la tarea.
  3. Comprobar que no exista nada nuevo en Development a incorporar en la rama de trabajo a través de una operación de rebase.
  4. Solucionar los conflictos de código surgidos en el punto anterior y actualizar los cambios en la rama de trabajo.
  5. Generar un Pull Request a la rama de Development.
  6. El equipo realiza una revisión del código y envía mensajes al desarrollador en el caso de que surja algún comentario.
  7. Si hay algo que corregir, trabajar los nuevos cambios y seguir los mismos pasos desde el punto 2.
  8. Si está todo correcto, puede que exista alguna persona con el role de “Merger” que acepte los cambios o simplemente algún miembro del equipo realiza la fusión.
Git3

Actualización de Stage y Master utilizando Pull Requests

En el momento en el que se decida sacar un nuevo release, puede ser necesario actualizar las ramas de Stage (UAT / Release) o Master (última versión estable del producto). Para esto, el proceso a seguir consiste en realizar una solicitud de integración desde Development a Stage o Master, según corresponda.

La recomendación es primero hacer una solicitud de integración a Stage, en la cual el usuario valide la funcionalidad y luego, en el caso de que la versión sea validada, realizar desde esta rama una solicitud de integración a Master.

Este proceso evita realizar commits directos en Stage o Master y asegura que lo que se está volcando es la diferencia entre ambas ramas, es decir, las nuevas funcionalidades.

Beneficios de usar Pull Requests

Desde hace ya algunos años los Pull Request han ganado un lugar en la forma de trabajo de los equipos. Los beneficios que propone se categorizan tanto desde el punto de vista disciplinario como de asegurar la calidad del código que se está produciendo. Algunos de los beneficios que se pueden mencionar son:

Si bien es común pensar que varias de las acciones aquí mencionadas pueden ser resueltas con herramientas automáticas, siempre es positiva una inspección del equipo para asegurar que la calidad del código generado es la mejor posible.

De forma adicional, permite mantener un historial limpio y claro de los cambios que hemos realizado (cosa que no siempre se cuida en proyectos donde trabajan muchas personas) para que el change log del proyecto resulte entendible.

Fundamentalmente, el máximo beneficio, es lograr que el equipo trabaje en forma mancomunada y colaborativa, tratando de ayudarse entre ellos a mantener el máximo estándar posible de calidad de código tanto del proyecto como de la empresa donde realizan sus proyectos.

Fuentes

Cuéntanos qué te parece.

Enviar.

Los comentarios serán moderados. Serán visibles si aportan un argumento constructivo. Si no estás de acuerdo con algún punto, por favor, muestra tus opiniones de manera educada.