DevOps
Si desarrollas en Windows utilizando WSL2 (Ubuntu, Debian, etc.), uno de los primeros obstáculos al configurar tu entorno es la autenticación con tu proveedor de Git. Usar HTTPS e ingresar credenciales o tokens en cada git push o git pull resulta incómodo e ineficiente.
La solución limpia y estándar en la industria es usar llaves SSH. En esta guía te muestro cómo configurarlas en menos de 5 minutos directamente desde la terminal de tu WSL hacia GitLab.
1. Abrir la terminal de WSL
Asegúrate de ejecutar tus comandos dentro de la distribución de Linux en WSL y no en el PowerShell de Windows.
#Verifica que estés en tu home directory de Linux
cd ~
2. Generar un nuevo par de llaves SSH
Utilizaremos el algoritmo ED25519, que actualmente es la recomendación estándar por ser más seguro y rápido que RSA.
Ejecuta el siguiente comando (reemplaza con tu correo registrado en GitLab):
ssh-keygen -t ed25519 -C "tu-email@ejemplo.com"
Ruta del archivo: Presiona Enter para guardar la llave en la ubicación por defecto (~/.ssh/id_ed25519).
Passphrase (Opcional): Puedes ingresar una frase de paso para mayor seguridad o presionar Enter dos veces para dejarla sin clave.
3. Iniciar el agente SSH y añadir la llave
Para que tu entorno en WSL administre la llave de forma automática, inicia el ssh-agent:
eval "$(ssh-agent -s)"
A continuación, añade tu clave privada al agente:
ssh-add ~/.ssh/id_ed25519
4. Copiar la llave pública
Para registrar la llave en GitLab, necesitas copiar el contenido de tu llave pública (id_ed25519.pub).
Muestra el contenido en consola con cat:
cat ~/.ssh/id_ed25519.pub
5. Registrar la llave en GitLab
- Inicia sesión en GitLab.
- Haz clic en tu foto de perfil (esquina superior derecha/izquierda según la interfaz) y ve a Preferences / Preferencias.
- En el menú lateral, selecciona SSH Keys.
- Haz clic en Add new key.
- Pega tu llave pública en el campo Key.
- Asígnale un Title descriptivo (ej: WSL-Ubuntu-Laptop).
- Selecciona una fecha de expiración si lo requiere tu política y haz clic en Add key.