¿Qué es clone? Cómo copiar el repositorio de GitHub de otra persona a tu PC

En los artículos anteriores, has dominado cómo subir (hacer push) un proyecto creado en tu PC (local) a un repositorio en GitHub. Con esto, has adquirido las bases para gestionar tu propio código con GitHub.

El tema de hoy es el patrón inverso, es decir, cómo copiar un repositorio (proyecto) de otra persona desde GitHub a tu propio PC. Esta operación se llama "clone" (clonar). Es un comando crucial y el verdadero primer paso para utilizar excelentes proyectos de código abierto de todo el mundo o para participar en el desarrollo en equipo. ¡Vamos a aprender cómo se hace!

¿Qué es `git clone`? La diferencia con una simple descarga

En la página de un repositorio de GitHub, en el botón verde "Code", también existe la opción "Download ZIP". Podrías pensar: "Si solo quiero copiar los archivos, ¿no es suficiente con esto?". Sin embargo, `git clone` y la descarga de un ZIP son cosas que, aunque parecidas, son completamente diferentes.

• Descarga ZIP: Simplemente descarga el conjunto de archivos del proyecto en ese momento preciso, como archivos normales. No incluye el directorio `.git`, que contiene el historial de cambios (el registro de commits). Es decir, no te beneficias de la gestión de versiones.
• git clone: Además de todos los archivos del proyecto, también copia todo el historial de cambios (todos los commits). Esto crea un nuevo repositorio local completamente funcional en tu PC. Puedes retroceder en el historial de cambios o hacer commit de nuevas modificaciones inmediatamente.

Para que se entienda mejor, se podría decir que la descarga ZIP es como "recibir solo una fotocopia de la última página de un libro", mientras que `git clone` es como "conseguir un ejemplar nuevo y completo del mismo libro".

Procedimiento práctico para `git clone`

Ahora, vamos a usar el comando `git clone` en la práctica para copiar un repositorio de GitHub a tu PC.

Paso 1: Copia la URL del repositorio que quieres clonar

Primero, accede a la página de GitHub del proyecto que quieres copiar. Para este ejemplo, vamos a clonar el repositorio del famoso framework de CSS, "Bootstrap".

Una vez en la página, haz clic en el botón verde "Code". Verás varias opciones para copiar la URL. Aunque hay HTTPS y SSH, como en el artículo anterior configuramos la clave SSH, es más cómodo usar la URL de SSH. Usar SSH te permite omitir la introducción de la contraseña al hacer push o pull.

[Imagen: Haciendo clic en el botón "Code" del repositorio de GitHub de Bootstrap y copiando la URL de SSH.]

Haz clic en el icono de copiar a la derecha de la URL para copiarla a tu portapapeles.

Paso 2: Ejecuta el comando `git clone` en la terminal

A continuación, abre la terminal (o Git Bash si estás en Windows) y navega hasta la ubicación donde quieres guardar el proyecto. El escritorio o una carpeta de desarrollo como `projects` son buenas opciones.

Una vez allí, es el momento de usar el comando `git clone`. Como se muestra a continuación, ejecuta el comando seguido de la URL que acabas de copiar.

git clone [Pega aquí la URL de SSH que copiaste]

Si clonas el repositorio de Bootstrap, el comando concreto sería el siguiente:

git clone git@github.com:twbs/bootstrap.git

Al ejecutarlo, comenzará la descarga. Dependiendo del tamaño del repositorio, puede tardar un poco.

Paso 3: Confirma que se ha clonado correctamente

Cuando el comando finalice, se habrá creado en tu directorio actual una carpeta con el mismo nombre que el repositorio (en este caso, `bootstrap`). ¡Vamos a comprobarlo!

ls

Si encuentras una carpeta llamada `bootstrap`, entra en ella.

cd bootstrap

Con esto, ya tienes un repositorio completo de Bootstrap en tu PC. Esta carpeta ya está bajo el control de Git, por lo que no es necesario ejecutar `git init` ni nada parecido.

Primeros pasos después de clonar

Una vez que has clonado un repositorio, puedes empezar a trabajar en el proyecto inmediatamente. Aquí te presentamos algunos comandos que se suelen usar antes de empezar a trabajar.

Comprobar las ramas (branches)

Para ver qué ramas de trabajo existen, puedes usar el comando `git branch`. Si añades la opción `-a`, también podrás ver las ramas del repositorio remoto.

git branch -a

Obtener los últimos cambios

Es posible que el repositorio que has clonado sea actualizado por otras personas mientras tú trabajas. Antes de empezar, asegúrate de ejecutar siempre el comando `git pull` para reflejar el estado más reciente del repositorio remoto en tu repositorio local.

git pull

Nota importante: Si quieres contribuir, empieza con un "Fork"

Aquí introducimos un concepto importante. No puedes hacer push de tus cambios directamente a un repositorio ajeno en el que no tienes permisos de escritura. Si quieres "contribuir" a ese proyecto añadiendo funciones o corrigiendo errores, primero debes realizar una operación llamada "Fork".

Un Fork es una función que copia un repositorio ajeno por completo a tu propia cuenta de GitHub, creando un repositorio remoto exclusivo para ti.

El flujo básico para contribuir a un proyecto de código abierto es el siguiente:

1. Hacer Fork en GitHub del proyecto al que quieres contribuir.
2. Hacer clone a tu PC del repositorio que se ha creado en tu cuenta a raíz del Fork.
3. Modificar el código en tu PC y hacer push a tu propio repositorio remoto.
4. En GitHub, enviar una "Pull Request" desde tu repositorio al proyecto original, solicitando que incorporen tus cambios.

Primero, familiarízate con `clone`, y como siguiente paso, ¡anímate a probar a hacer una pull request desde un fork!