Ya hemos aprendido a usar Git en local, dominamos los commits y los reverts. También tenemos nuestro remoto (Github o GitLab) configurado. Olé tu.
Ahora ¿Cómo empezamos a subir nuestros ficheros? Dependiendo de tu caso, el camino es distinto
Tenemos dos escenarios posibles:
| Situación | Comando |
|---|---|
| Ya tengo código. He empezado en local y quiero subirlo a un repo nuevo. | git remote add origin <url> |
| No tengo el código. Está en Internet y quiero empezar a trabajar en él. | git clone <url> |
Hoy vamos a ver las dos opciones git remote add y git clone.
Subiendo tu código local (git remote add)
Escenario 1️⃣, has creado una carpeta en tu PC, has hecho git init, has programado durante semanas y tienes un historial de 50 commits.
Es decir, el proyecto lo has creado tú y lo tienes en tu ordenador y quieres subirlo a la nube por primera vez.
El proceso consta de 3 pasos:
Ve a GitHub/GitLab y crea un “New Repository”.
Crea el repositorio totalmente vacío. No marques las casillas de “Add a README file”, .gitignore o License.
Si lo creas con archivos, GitHub tendrá una historia diferente a la tuya y tendrás conflictos al intentar subir tu código (el famoso error refusing to merge unrelated histories).
Una vez creado, GitHub te dará la URL. Ahora, en tu terminal (dentro de tu proyecto), ejecuta:
git remote add origin [email protected]:tu-usuario/tu-proyecto.git
remote add: Añade una referencia remota.origin: El nombre que le damos (recuerda, es una convención).<url>: La dirección del servidor.
Si ejecutas git remote -v, verás que ya está conectado. Pero aún no has subido nada. Solo has configurado el remoto.
Ahora toca enviar tus archivos. Como es la primera vez, necesitamos configurar el “camino por defecto”. Ejecuta:
git push -u origin main
Si trabajas con un GUI, como con VSCode, al crear tu repositorio, lo normal es que te aparezca un botón como ‘Publish branch”, que te permitirá hacer todo lo anterior en un click.
Descargando un proyecto (git clone)
Escenario 2️⃣, el proyecto ya existe en la nube y quieres descargarlo a tu ordenador (por ejemplo, entras a trabajar en una empresa o quieres colaborar en Open Source).
Entonces clonamos el repositorio remoto.
git clone <url-del-repositorio>
Por ejemplo, usando la URL SSH que aprendimos a conseguir en el artículo anterior:
git clone [email protected]:luisllamas/mi-proyecto.git
Si quieres que la carpeta se llame distinto al repo original, pon el nombre al final: git clone <url> mi-carpeta-personalizada
Error común: Clonar dentro de un repositorio
A veces, por despiste, hacemos un git clone estando situados dentro de una carpeta que ya es un repositorio.
/MiProyecto (tiene .git)
/LibreriaExterna (hacemos git clone aquí)
/.git
Esto crea “repositorios anidados” (Submodulos no declarados). Git se hará un lío y probablemente no rastree bien la carpeta interior.
Asegúrate siempre de hacer git clone en una carpeta neutra (como Escritorio o Documentos/Proyectos), nunca dentro de otro proyecto Git.
