7 Git: sistema de control de versiones

7.1 Trabajo previo

7.1.1 Tutoriales

• Abba, I. V. (2021). Git and GitHub Tutorial – Version Control for Beginners. FreeCodeCamp.Org. https://www.freecodecamp.org/news/git-and-github-for-beginners/

7.1.2 Otros

• Instale en su computadora el sistema de control de versiones Git.

7.2 Resumen

Git es un sistema para administrar versiones de código fuente o, en general, de cualquier conjunto de archivos.

7.3 Descripción general

Git es un sistema de control de versiones diseñado para rastrear cambios en el código fuente durante el proceso de desarrollo de software. Sin embargo, puede ser utilizado para llevar el control de los cambios en cualquier conjunto de archivos (ej. documentación, música).

Un sistema de control de versiones proporciona, entre otras ventajas:

• La capacidad de recuperar versiones anteriores del conjunto de archivos.
• La capacidad de integrar modificaciones efectuadas por varias personas en el conjunto de archivos.
• La capacidad de mantener varias “ramas” (branches) de un producto (ej. “estable”, “evaluación”, “inestable”, como en el caso de Debian Linux, GRASS GIS y muchos otros proyectos de software libre).
• Facilidades para mantener redundancia y respaldos de los archivos (ej. Programa de respaldos de GitHub).

Git fue diseñado por Linus Torvalds en 2005 durante del desarrollo del kernel del sistema operativo Linux. Se caracteriza por ser un sistema de control de versiones distribuido, lo que significa que el código fuente puede estar alojado en la estación de trabajo de cualquier miembro del equipo de desarrollo (i.e. no tiene que existir un repositorio central).

El protocolo de Git es utilizado en varios sitios que proveen servicios de alojamiento de software, entre los que están SourceForge, Bitbucket, GitLab y GitHub.

7.4 ¿Como funciona Git?

Desde el punto de vista de un usuario de Git (ej. un programador), Git se utiliza para sincronizar la versión local de un conjunto de archivos, llamado proyecto o repositorio, con la versión que está alojada en un sistema remoto (ej. GitHub). Cada repositorio se almacena en un directorio (carpeta) del sistema operativo. La sincronización se realiza principalmente a través de dos operaciones:

• push: para “subir” al repositorio remoto los cambios realizados en el repositorio local. Esta operación se realiza mediante el comando git push. Es probable que el sistema remoto le solicite al usuario algún tipo de autenticación (ej. nombre de usuario y clave).
• pull: para “bajar” al repositorio local los cambios realizados en el repositorio remoto. Esta operación se realiza mediante el comando git pull.

Las operaciones push y pull se ilustran en la figura 7.1.

Figure 7.1: Operaciones push y pull. Imagen de Melinda Higgins.

Antes de un push, el usuario debe seleccionar los archivos que desea subir mediante el comando git add, el cual pasa los archivos a un “área de espera” (staging area). Luego debe usarse el comando git commit para “guardar” los cambios en el área de espera.

La relación entre estas operaciones de Git, se ilustra en la figura 7.2.

Figure 7.2: Operaciones de Git. Imagen de Steven Klavins.

En la figura 7.3 se muestra el funcionamiento de Git mediante una comparación con el procesamiento de una compra en línea.

Figure 7.3: Operaciones de Git y compras en línea. Imagen de Melinda Higgins.

Otras operaciones de Git de uso frecuente son:

• git config: para especificar opciones globales de la sesión de Git (ej. nombre del usuario, dirección de corre electrónico).
• git clone: para clonar (i.e. copiar) un repositorio remoto en la computadora local.
• git status: para revisar el estado de los archivos y, por ejemplo, saber cuales deben pasarse al área de espera.

7.5 Ejemplos de uso

7.5.1 Clonación de un repositorio remoto y sincronización de los cambios efectuados localmente

Para seguir este ejemplo:

1. Bifurque (fork) a su cuenta en GitHub el repositorio localizado en la dirección https://github.com/gf0604-procesamientodatosgeograficos/2022-i-tutorial-git-repo-ejemplo.
   
2. Con la opción File - New Project - Version Control - Git de RStudio, clone a su computadora el repositorio que acaba de bifurcar.
3. Con el editor de RStudio, abra el archivo README.md, agregue una línea y guarde el archivo.
   
4. Luego, ejecute los siguientes comandos desde la la ventana Terminal de RStudio. Nota: las líneas que empiezan con # son comentarios.

# 0. Especificación del nombre y de la dirección de correo del usuario.
# Debe modificar la dirección de correo y el nombre del usuario con sus propios datos.
$ git config --global user.email usuario@correo.com
$ git config --global user.name usuariogithub
# Para revisar:
$ git config --global --list

# 1. Revisión de los archivos con modificaciones.
$ git status

# 2. Adición de los archivos modificados al "área de espera".
# El punto (.) indica que se agregarán todos los archivos modificados.
$ git add .

# 3. Almacenamiento (commit) del conjunto de archivos modificados, junto con un mensaje explicativo.
$ git commit -m "Agregar línea 2"

# 4. "Subida" (push) de las modificaciones al repositorio remoto.
$ git push

Revise los cambios aplicados en el repositorio remoto en GitHub. Si se realizan nuevos cambios en el repositorio local, deben repetirse los pasos del 1 al 4. Los comentarios en el commando commit deben reflejar los cambios realizados.

7.6 Recursos de interés

GitHub Archive Program. (s. f.). GitHub Archive Program. Recuperado 10 de abril de 2022, de https://archiveprogram.github.com/

Higgins, M. (s. f.). Reproducible Templates for Analysis and Dissemination. Coursera. Recuperado 11 de abril de 2022, de https://www.coursera.org/learn/reproducible-templates-analysis

Klavins, S. (2020). Version Control part 1. Medium. https://stevenklavins94.medium.com/version-control-part-1-c5f1b43127f6