Cómo utilizar Git y GitHub desde RStudio
10 May 2022 - Lizeth Reyes
Git en RStudio 📸 🗃️
Introducción
Git es un sistema de control de versiones. Git realiza seguimiento de los cambios de código y comparte esos cambios con otros, ya que nos permite fusionar estos cambios. Existen diferentes formas de usar Git: desde la línea de comandos, utilizando RStudio o una aplicación independiente (GitKraken), etc. Para esta primera etapa nos centraremos en el uso de Git en RStudio.
RStudio es un entorno de desarrollo integrado para el lenguaje de programación de R, dedicado a la computación estadística y gráficos. RStudio incluye una consola, herramientas para el trazado, depuración y gestión del espacio de trabajo, la terminal, y la herramienta para trabajar con Git.
Objetivo
- Aprender a usar Git en RStudio.
Configurar la autenticación con una clave SSH
Antes de comenzar a trabajar en RStudio debemos configurar la autenticación con la clave SSH. Primero revisaremos que no hay ninguna llave generada. Para ello, vamos a correr el comando que mostramos en la imagen. En la imagen podemos notar que la terminal no despliega ninguna lista de llaves generadas.
Después, vamos a crear nuestra llave ejecutando el siguiente comando ssh-keygen
. En seguida,
se indica la carpeta en donde se almacenará la llave y nos pedirá una contraseña; si lo prefieres
puedes omitir la contraseña con la tecla Entrar
.
Al finalizar, se mostrará lo siguiente.
Ahora vamos a acceder a nuestra llave para copiarla y asociarla a GitHub. Ejecutaremos el
siguiente comando cat ~/.ssh/id_rsa.pub
. Copiamos desde ‘ssh… hasta la terminación
.local’
A continuación nos dirigiremos a nuestro GitHub. Una vez ahí, buscaremos Settings.
En Settings encontraremos múltiples opciones para configurar, lo que a nosotros nos interesa es el apartado de Access, específicamente en SSH and GPG Keys.
Damos clic en la opción de New SSH Key.
Agregamos un título, pegamos la llave que hemos copiado de la terminal y finalmente la agregamos.
Clonar nuestro repositorio en RStudio
A continuación, buscaremos el repositorio que vamos a clonar.
Daremos clic en la opción Code que se marca en verde, y después elegimos la opción SSH y copiamos la dirección con el botón que se encuentra a lado.
En seguida, abriremos la aplicación de RStudio. En el apartado File elegiremos la opción New Project. Se desplegará una ventana como la siguiente y seleccionamos la opción Version Control e inmediatamente Git.
Pegamos la dirección que habíamos copiado de GitHub. Después de pegar la dirección, el nombre y la carpeta de origen se asignan por defecto, podemos cambiar esto si lo preferimos. Finalmente, daremos clic en Create Project.
Ahora podemos ver el nombre del proyecto en la esquina superior derecha, señal de que el proyecto está configurado y listo para trabajar con el repositorio. También, podemos notar que automáticamente cambiamos al directorio donde están los archivos del repositorio y diferentes botones nos permiten hacer Pull, Push, y Commit.
Git add, git commit y git push
En el panel de cambios notaremos que hay tres archivos con un signo de interrogación. Esto significa que estos archivos no tienen ningún seguimiento dentro de nuestro repositorio y tendrán que ser agregados. Para esto, hay que agregar los archivos seleccionando las casillas. Esto hará que las casillas cambien a una A, lo que indica que los archivos están siendo agregados. El mensaje de consignación deberá tener un título y una descripción. El titulo será escrito de forma imperativa, comenzando con un verbo, y en inglés, mientras que la descripción explicará el porqué se realizaron esos cambios.
Ahora modificaremos uno de los archivos para diferenciar cuando agregamos o eliminamos líneas de código. Notaremos que al agregar una línea de código se marca en color verde, en cambio, si la eliminamos se marca en color rojo.
Haremos nuestra primera consignación y RStudio nos dará un aviso de lo que esta pasando. El mensaje significa que nuestro repositorio tiene cambios que aún no los tiene el repositorio remoto.
Entonces, el último paso es empujar los cambios con el botón Push que se encuentra en la parte superior derecha.
Resumen y comparación entre RStudio y la terminal
RStudio | Git |
---|---|
$ git add file_name | |
$ git commit -m "m e s s a g e" | |
$ git push | |