Opcional: realizar un fork del portal

Esta guía tiene como objetivo generar una versión propia del portal SIU-Huarpe, que tenga cambios y personalizaciones respecto del original.

Estos cambios pueden surgir en forma de:

• agregar y activar bundles adicionales: nueva funcionalidad propia de la institución.
• personalizaciones sobre bundles existentes: cambios en el código, ocultar acciones, etc.
• ajustes menores o de configuración: empaquetar en Docker de forma predecible los ajustes de la institución

Requisitos

1. Repositorio privado Git (tipo Gitlab)
2. Manejo de Git
3. Ganas de desarrollar :-)

Inicializar

Por única vez, es necesario inicializar el repositorio que contendrá la versión personalizada del portal SIU-Huarpe.

Inicializar repositorio vacío

Si tenemos Gitlab, crear un proyecto vacío. De lo contrario, crearlo como un repositorio local git:

git clone https://git.uunn.local/deploy

De lo que se intenta hacer es tener un repositorio que será una copia del original, donde alojaremos cambios locales o propios de nuestro fork.

Configurar origen

Primero se indica la url del repositorio original como upstream

git remote add upstream https://hub.siu.edu.ar/siu-arai/huarpe-core.git

Descargar los archivos del repositorio upstream

git fetch upstream

Una vez completada la descarga, realizar un merge contra el repositorio aún vacío

git merge upstream/master

Si ahora ejecutamos ls veremos que ya tenemos el código en nuestra working copy. Podemos ejecutar el siguiente comando para verificar a que versión estamos apuntando.

cat version

Este es un buen momento para subir el código a nuestro repositorio local:

git push

Realizar nuestros cambios

Ahora es el momento de realizar las personalizaciones, ajustes, incluir un nuevo bundle, etc. a nuestra versión del portal SIU-Huarpe.

git commit -m "inicial"

y

git push

Esto subirá los cambios commiteados, al repositorio local que continene el fork de SIU-Huarpe.

Consideraciones

• evitar registrar cambios innecesarios
• si se introduce un nuevo bundle, que no entre en conflicto con existentes

Actualizar con cambios desde el origen

Imaginemos que se libera una nueva versión de SIU-Huarpe. El objetivo de este paso es lograr incorporar los cambios de la nueva versión sin perder los cambios propios de nuestro fork. Para hacer esto ejecutaremos (sobre la working copy sin cambios pendientes de commitear):

git fetch upstream

y mezclaremos los cambios de la versión original, con nuestros cambios propios

git merge upstream/master

Es posible que en este paso ocurra algún conflicto. Si es así, seguir los pasos indicados en el output del merge. Al finalizar, deberemos subir al repositorio remoto de nuestro fork los cambios recién fusionados:

git push