Git es una herramienta para mantener repositorios de código en un sistema de control de versiones y facilitar el trabajo colaborativo en los equipos. Github explota esta funcionalidad y la ofrece desde la nube, lo que nos facilita acceder desde cualquier lugar y cualquier dispositivo. Simplemente nos conectamos al repositorio creando una copia local sobre la que trabajamos y luego publicamos al repositorio de Github. Esta metodología de versionado nos ofrece un repositorio versionado en local que podemos unir al principal en Github cuando queramos. En el siguiente artículo vamos a ver cómo conectar una carpeta local a un repositorio Github.
En primer lugar debemos capturar la URL del repositorio en Github que vamos a clonar. Podemos encontrarla en la página del mismo https://github.com/hegdehog/PolylineGenerator. Al pulsar en el botón <> Code se despliega una ventana donde nos ofrecen varias opciones de clonado. Vamos a utilizar la primera y más básica, que es copiar la URL de HTTPS:
El clonado lo vamos a realizar por línea de comandos. Si trabajamos con Windows podemos usar CMD o un emulador de terminal de Unix. En mi caso, utilizo git bash (MINGW64) que se puede descargar desde la web de Git.
Lo primero que vamos a hacer es configuramos un nuevo usuario de Git (que no Github, podemos asignarle el nombre que deseemos) y un email (para gestionar los cambios en Github):
$ git config --global user.email "nagash87@gmail.com"
$ git config --global user.name "Marcos"
Nos dirigimos a la ruta de nuestro equipo local donde vamos a clonar el repositorio de Github. En nuestro ejemplo, hemos creado la carpeta Repos en la unidad C:
$ cd C:\ReposEl siguiente paso es clonar el repositorio de github en el directorio local. Recuerda reemplazar la URL del ejemplo por la de tu repo. Al ejecutar el comando git clone nos solicitará logarnos en github para autorizar la operación:
$ git clone https://github.com/hegdehog/PolylineGenerator.gitNos desplazamos al directorio donde se acaba de clonar el repositorio:
$ cd PolylineGenerator/Podemos comprobar el estado de la repo para chequear si se ha descargado correctamente y está conectada a la repo en Github utilizando el comando git status.
$ git statusSi hemos realizado correctamente todos los pasos, el output del comando será que no hay cambios detectados:
¡Ya tenemos la repo de Github clonada en local! Si añadimos un nuevo fichero o hacemos algún cambio en los que hemos clonado, el control de versiones de git lo detectará y nos permitirá hacer los commits en local y posteriormente el push a Github. Vamos a ver varios ejemplos:
Creamos un nuevo fichero prueba.txt y volvemos a ejecutar el comando git status, nos indicará que se ha detectado un nuevo fichero que no está incluido para hacer el commit:
Para añadir el fichero recién creado usaremos el comando git add y luego git commit para salvar los cambios en nuestro repositorio local. Si tenemos varios ficheros con cambios/nuevos, podemos utilizar git add .
$ git add .
La otra opción para añadir uno a uno los ficheros, es usando el comando git add y el nombre del fichero:
$ git add prueba.txtAhora vamos a hacer commit de los cambios en el repositorio local utilizando el comando git commit:
$ git commit -m "Se añaden ficheros"
Si ahora ejecutásemos un git status nos diría que que nuestra branch está por delante del main del repositorio en github por 1 commit, que es el que acabamos de lanzar:
El último paso sería actualizar el repositorio principal en github con el repositorio local, para lo que usaremos el comando git push. previo a esto vamos a recuperar el nombre del remote utilizando el comando git remote -v:
$ git remote -v
Como podemos ver, el remote es origin, por lo que vamos a realizar el push sobre él. El comando git push tiene dos parámetros, el remote y el nombre de la rama donde vamos a publicar los cambios. En nuestro caso vamos a hacerlo directamente sobre la principal (main), por lo que el comando nos quedaría de la siguiente forma:
$ git push origin main
Cómo último paso del ejercicio, vamos a borrar los dos ficheros dummy que hemos creado para la prueba. Para ello, ejecutamos el comando inverso del add, que es git rm. Hacemos el remove de los dos ficheros de prueba y lanzamos un git status:
git rm prueba.txt
git rm prueba2.txt
git status
Repetiríamos los pasos del commit y push para actualizar el repositorio local y el de github.