Guia Git / Github

Ubuntu

Para establecer la configuración necesaria introducimos en la terminal los siguientes comandos:

sudo apt update

sudo apt upgrade

sudo apt-get install curl

sudo apt install git-all

sudo apt install wget

Windows

Windows Subsystem Linux

Primero instalamos Windows Subsystem Linux (WSL) de la siguiente manera, para ello abrimos el PowerShell de Windows y ejecutamos el siguiente comando:

wsl --install

Una vez que se complete la instalación abre la tienda Microsoft Store desde el menú de inicio, busca la distribución de Linux que desees instalar (en nuestro caso sería Ubuntu), dar click en ‘Obtener’ / ‘Instalar’ y por último una vez instalado podremos iniciar la distribución desde el menú Inicio o ejecutándola desde el PowerShell.

Más información: https://learn.microsoft.com/en-us/windows/wsl/install

WGet

Es una herramienta de línea de comandos utilizada para descargar archivos de la web. Su instalación se lleva a cabo de la siguiente manera:

• Abrimos WSL (Windows Subsystem Linux)
• Introducimos en la terminal el siguiente comando:

sudo apt install wget

Curl

Es una herramienta de línea de comandos utilizada para transferir datos con URL. Su instalación se lleva a cabo de la siguiente manera:

• Abrimos WSL (Windows Subsystem Linux).
• Introducimos en la terminal el siguiente comando:

sudo apt install curl

Git

Instalamos Git de la siguente manera:

• Abrimos WSL (Windows Subsystem Linux).
• Introducimos en la terminal el siguiente comando:

sudo apt install git-all

MacOS

En MacOs desde la terminal instalamos Brew, Curl y WGet de la siguiente manera:

Brew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Más información: https://brew.sh/

Curl

brew install curl

WGet

brew install wget

Git

brew install git

Más información: https://git-scm.com/download/mac.

Windows / MacOS / Ubuntu

Importante: Si estamos usando como Sistema Operativo Windows antes de ejecutar los comandos indicados abajo debemos abrir Windows Subsystem Linux (WSL) y ejecutar los comandos desde dicha terminal.

Una vez dicho esto vamos a configurar Git ejecutando los siguientes comandos:

git config --global user.name "JohnDoe"

git config --global user.email johndoe@email.com

Nota: En donde aparecen “John Doe” y johndoe@exameple.com pondremos el nombre de usuario y el email que vayamos a usar, en este caso el que tengamos en Github.

Más información: https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration

Una vez que ya tenemos Git configurado pasamos a generar una clave SSH y añadirla a nuestra cuenta de Github.

¿Cómo crear la clave SSH?

Accedemos al directorio que contiene la carpeta .ssh, la ruta debería ser /home/nombre-de-usuario, en mi caso:

cd home/adrian

Si miráis el contenido de esta carpeta con veréis que no aparece ninguna carpeta llamada .ssh. Esto es porque se trata de una carpeta oculta (todas las carpetas ocultas empiezan por .), pero aunque no lo veamos está ahí. Para ver las carpetas ocultas de un directorio usamos el comando:

ls -a

Si nos aparace la carpeta .ssh borramos dicha carpeta con el siguiente comando:

rm -r .ssh

Volvemos a generar una clave SSH, no os preocupéis, os paso los comandos pasito a pasito: Aquí abajo acordaos de cambiar your_email@example.com por el correo que utilizasteis para registraros en GitHub, ¡¡debe ser el mismo!! Vamos a generar una clave SSH para ello ejecutamos el siguiente comando:

 ssh-keygen -t ed25519 -C "your_email@example.com"

Nota: En donde "youremail@example.com" pondremos nuestro email de Github.

Le damos a enter hasta que nos termine de preguntar sin introducir nada(3veces).

Ahora nos aseguraremos de que todo se haya generado correctamente y que los archivos tengan los permisos correctos. Dentro de la carpeta .ssh debería haber 2 archivos: id_ed25519 e id_ed25519.pub.

ls -l .ssh

Los permisos del archivo id_ed25519 deberían ser -rw-------, y las de id_ed25519.pub, -rw-r--r--. Si no tienen esos permisos, corregidlos con el comando chmod tal y como aprendimos en la primera clase de Linux Intro.

Ahora iniciaremos el agente que nos gestionará todas nuestras llaves y le damos la llave SSH que habíamos generado:

eval "$(ssh-agent -s)" 

ssh-add ~/.ssh/id_ed25519

Por último copiamos (copiamos todo menos el email que nos aparece al final) la clave con el comando que os paso aquí abajo y pegamos lo que nos sale en la sección de Settings -> SSH and GPG keys. IMPORTANTE: no dejar espacios al principio ni al final.

cat ~/.ssh/id_ed25519.pub

¿Cómo añadir clave SSH a nuestra cuenta de Github?

Si el archivo de tu clave pública SSh tiene un nombre diferente al del código de ejemplo, modifica el nombre del archivo para que coincida con tu configuración actual. Al copiar tu clave, no agregues saltos de línea ni espacios en blancos nuevos.

En la esquina superior derecha de cualquiera de las páginas de Github, haz click en tu foto de perfil y luego en Configuración (Settings) y luego haz click en el apartado ‘SSH and GPG Keys’ que aparece en la izquierda.

Una vez estemos dentro de la sección SSH and GPG Keys hacemos click en New SSH:

Debería aparecernos la siguiente vista:

Como título por algo que sea descriptivo, si es tu ordenador personal puedes poner ‘Ordenador Personal’ por ejemplo. En el apartado Key Field pega la clave que obtuviste anteriormente mediante el comando cat, copiando todo menos el email que nos da como mencionamos anteriormente, y haz click en ‘Add SSH key’ y ya todo debería estar listo.