Flujos de Trabajo

Flujos de trabajo usado por el Área de Ingeniería en sus repositorios de Git.

Proyectos Del Área

Este es el flujo utilizado en los repositorios de los distintos proyectos del Área de Ingeniería, como esta misma documentación.

Recientemente, se ha cambiado el flujo de trabajo para fomentar la revisión del código entre los miembros del área de ingeniería.

Pasos

Se integran todos los cambios realizados por el equipo en la rama principal.
Ventana de terminal
```
git pull
```
Se crea una rama local de desarrollo si esta no existía previamente.
Ventana de terminal
```
git branch nombre_de_rama
```
Esta puede ser una rama personal donde se realiza todo el trabajo o una rama específica para una serie de cambios. Este último método permite segmentar los cambios en distintas ramas de desarrollo en caso de que se esté trabajando en varias cosas al mismo tiempo.
Se cambia a la rama de desarrollo.
Ventana de terminal
```
git switch nombre_de_rama
```

Se pueden hacer estos dos pasos en un solo comando con:

git switch -c nombre_de_rama

Se realizan cambios en los archivos.
Se marcan los cambios para el próximo commit.
Ventana de terminal
```
git add <archivos...>
```
Se realiza un commit con los cambios marcados.
Ventana de terminal
```
git commit -m "Mensaje..."
```
El Área de Ingeniería intenta seguir las reglas de los commits convencionales para estos mensajes.
Después de realizar los cambios y commits necesarios. Se “empuja” la rama al repositorio remoto.
Ventana de terminal
```
git push origin nombre_de_rama
```
Después de esto, se visita el repositorio remoto en GitLab. Se debe crear una merge request para solicitar que estos cambios sean integrados a las ramas necesarias.

Se recomienda establecer un mensaje claro y dejar todos los cambios realizados en la descripción, para facilitar que la persona encargada de la revisión pueda aprobar los cambios rápidamente.
Si la persona asignada encuentra errores, se pueden hacer más commits arreglándolos y subirlos como en el paso anterior. Esto actualizará la merge request.
Una vez la merge request esté aprobada, el encargado la integrará con la rama principal y, opcionalmente, borrará la rama remota en la que se subieron los cambios originalmente.
Para limpiar el repositorio, se puede cambiar a la rama principal.
Ventana de terminal
```
git switch main
```
Integrar los cambios recién aprobados.
Ventana de terminal
```
git pull
```
Y borrar la rama de desarrollo.
Ventana de terminal
```
git branch -d nombre_de_rama
```
Para borrar las referencias a ramas remotas eliminadas, se pueden limpiar periódicamente con:
Ventana de terminal
```
git remote prune origin
```
Repetir el proceso.

Scripts

Para el repositorio de scripts, el proceso es similar. La única diferencia es que la rama principal (main en el caso anterior) es la correspondiente a la versión actual de Mekano. Esto afecta a los pasos 7 y 10.