Git - sistema de control de versiones#

Trabajo previo#

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/

Otros#

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

Instale en su computadora un editor de código fuente, por ejemplo:

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 de los archivos.

  • La capacidad de integrar modificaciones efectuadas por varias personas en el mismo 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). Esta es una facilidad que implementan algunos servicios en la nube.

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. No se requiere de un repositorio “central”, pero también se puede trabajar de esa forma.

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.

Funcionamiento#

Desde el punto de vista de un usuario de Git (ej. un programador), Git se utiliza para sincronizar la versión local (i.e. en la computadora personal del usuario) 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 Fig. 12.

../../_images/git-push-pull.png

Fig. 12 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 pendientes en el área de espera. Cada commit guarda el estado del conjunto de archivos en un momento específico (snapshot).

La relación entre estas operaciones de Git, se ilustra en la Fig. 13.

../../_images/git-push-pull-commit.png

Fig. 13 Operaciones de Git. Imagen de Steven Klavins.#

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

../../_images/git-stage-commit-push.png

Fig. 14 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 init: para inicializar un repositorio git.

  • 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.

  • git log: para revisar el historial de commits.

  • git show: para visualizar los cambios efectuados en los commits.

  • git reset: para regresar al estado correspondiente a un commit anterior.

Ejemplos de uso#

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

Para seguir este ejemplo:

  1. Obtenga un token de GitHub en la siguiente opción de menú de su perfil de usuario: Settings - Developer settings - Personal access tokens. Seleccione las operaciones de tipo “repo”. Copie el token en un lugar seguro, ya que lo necesitará para autenticarse en GitHub.

  2. Realice un fork a su cuenta en GitHub del repositorio localizado en la dirección https://github.com/gf0657-programacionsig/2022-ii-tutorial-git-repo-ejemplo. Obtendrá un repositorio llamado “https://github.com/[nombre-usuario]/2022-ii-tutorial-git-repo-ejemplo”, en donde [nombre-usuario] es su nombre de usuario en GitHub.

  3. En una terminal del sistema operativo, con el comando git clone https://github.com/[nombre-usuario]/2022-ii-tutorial-git-repo-ejemplo, clone a su computadora el repositorio que acaba de bifurcar.

  4. Con un editor de texto, abra el archivo README.md, agregue una línea y guarde el archivo.

  5. Luego, ejecute los siguientes comandos desde la terminal. Nota: las líneas que empiezan con # son comentarios.

# a. Cambio al directorio del repositorio.
cd 2022-ii-tutorial-git-repo-ejemplo

# b. Parámetros de configuración: nombre y dirección de correo del usuario.
#    Debe cambiar [email-usuario] y [nombre-usuario] por sus propios datos.
git config --global user.email [email-usuario]
git config --global user.name [nombre-usuario]
# Para revisar los parámetros de configuración:
git config --global --list

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

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

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

# f. "Subida" (push) de las modificaciones al repositorio remoto.
#    En este paso, es posible que deba utilizar su nombre de usuario/clave
#    o su token de GitHub para autenticarse.
git push

  1. Revise los cambios aplicados en el repositorio remoto en GitHub.

  2. Agregue más líneas al archivo del repositorio local y sincronícelo con el remoto, realizando nuevamente los pasos del c al f para cada commit. Recuerde que los comentarios de cada commit deben reflejar los cambios que están siendo aplicados.

Recursos de interés#

Git. (s. f.). Recuperado 28 de agosto de 2022, de https://git-scm.com/

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