En la primera práctica de Git de Implantación de Aplicaciones Web, el enunciado era sencillo: crear un repositorio en GitHub, clonarlo, añadir un archivo HTML y hacer el primer commit. Lo hice, y al lanzar git status para comprobar que todo estaba bien, Git me respondió con esto:
$ git status
En la rama main
Tu rama está basada en 'origin/main', pero upstream ha desaparecido.
(usa "git branch --unset-upstream" para arreglar)
nada para hacer commit, el árbol de trabajo está limpio
Revisando ahora las capturas de aquella práctica, el aviso aparece en todas, hasta la última. No rompía nada, así que seguí con la actividad. Pero tiene una explicación muy concreta, y la “solución” que propone el propio Git no es la que necesitas en este caso.
Qué es el upstream de una rama
Tu rama local main puede estar conectada a una rama del repositorio remoto, normalmente origin/main. A esa rama remota se le llama upstream. Esa conexión es lo que permite que:
git statuste diga si vas por delante o por detrás del remoto (“Tu rama está adelantada a ‘origin/main’ por 1 commit”).git pushygit pullsepan a dónde subir y de dónde bajar sin que tengas que indicarlo cada vez.
El mensaje dice que tu rama tiene configurado un upstream (origin/main), pero que esa rama no existe. La conexión apunta a un sitio vacío.
Por qué me pasó a mí: clonar un repositorio vacío
La pista estaba en el primer comando de la práctica:
$ git clone https://github.com/tu-usuario/Taller-de-Git.git
Clonando en 'Taller-de-Git'...
warning: Pareces haber clonado un repositorio sin contenido.
Había creado el repositorio en GitHub sin ningún archivo (sin README) y lo cloné tal cual. Al clonar, Git deja la rama main local preparada para seguir a origin/main. Pero en GitHub esa rama todavía no existía: un repositorio vacío no tiene ramas hasta que alguien sube el primer commit.
Después hice mi primer commit en local:
$ git commit -m "Initial Commit"
[main (commit-raíz) be1b97b] Initial Commit
1 file changed, 12 insertions(+)
Y a partir de ahí, git status empezó a avisar. La rama local ya tenía un commit y su upstream configurado era origin/main, pero origin/main seguía sin existir. Ese commit solo estaba en mi máquina virtual.
Esto responde también a una de las preguntas de la práctica: por qué los cambios no se reflejaban en github.com. Todo lo que haces con git add y git commit se queda en tu repositorio local. Hasta que no haces git push, GitHub no sabe nada de ello.
La solución correcta: hacer el primer push
Lo que falta es crear origin/main en GitHub, y eso se consigue subiendo la rama:
$ git push -u origin main
origines el remoto, en este caso GitHub.maines la rama que subes.-u(o--set-upstream) deja configuradoorigin/maincomo upstream de tumainlocal.
Después de eso, git status ya dice que tu rama está actualizada con origin/main y el aviso desaparece, porque la rama remota por fin existe.
Por qué no hacer caso a --unset-upstream
Git sugiere git branch --unset-upstream, y es tentador copiarlo tal cual. Lo que hace ese comando es borrar la conexión entre tu rama y la remota. El aviso desaparece, sí, pero:
- Tu commit sigue sin estar en GitHub.
- La rama ya no sabe a dónde subir: el siguiente
git pushsin parámetros fallará y te pedirá que indiques el upstream.
Es decir, quitas el síntoma sin arreglar nada. --unset-upstream tiene sentido en otro escenario: cuando la rama remota existía y se borró a propósito (por ejemplo, después de fusionar una rama de trabajo y eliminarla en GitHub) y ya no quieres que tu rama local la siga.
| Situación | Qué hacer |
|---|---|
| Repositorio vacío recién clonado, aún no has subido nada | git push -u origin main |
| La rama remota se borró y ya no la necesitas | git branch --unset-upstream |
| La rama remota se borró, pero quieres seguir subiendo esa rama | git push -u origin nombre-rama (la vuelve a crear) |
Cómo evitarlo desde el principio
Hay dos formas sencillas:
- Crear el repositorio en GitHub con un README. Así ya tiene un primer commit y una rama
main, y al clonarlo el upstream existe desde el primer momento. - Hacer el primer
git push -u origin mainjusto después del primer commit, antes de seguir trabajando.
Un detalle más: el enunciado de la práctica hablaba de la rama master, pero mi repositorio usaba main. GitHub crea los repositorios nuevos con main como rama por defecto desde 2020, así que muchos enunciados y tutoriales antiguos siguen diciendo master. Es el mismo concepto con otro nombre: usa la que te muestre git branch.
Y si el push no te deja subir
El push es justo el paso en el que más problemas he tenido durante el curso. No recuerdo el mensaje exacto de cada vez, pero lo terminé resolviendo con una clave SSH en lugar de usuario y contraseña. La causa más habitual de esos fallos es que GitHub dejó de aceptar la contraseña de la cuenta para operaciones de Git por HTTPS en 2021: ahora pide un token o una clave SSH.
Con SSH, primero se genera el par de claves y se muestra la pública:
$ ssh-keygen -t ed25519 -C "tu-correo@ejemplo.com"
$ cat ~/.ssh/id_ed25519.pub
La clave pública (la que acaba en .pub) se pega en GitHub, en Settings → SSH and GPG keys. La privada no sale nunca de tu equipo. Después se cambia la dirección del remoto para que use SSH en vez de HTTPS y se prueba la conexión:
$ git remote set-url origin git@github.com:tu-usuario/Taller-de-Git.git
$ ssh -T git@github.com
Si la respuesta de GitHub te saluda con tu nombre de usuario, la autenticación funciona y git push ya no te pedirá contraseña.
Cuando por fin subes el trabajo y empiezas a crear ramas, el siguiente susto suele llegar al fusionarlas. Lo cuento en qué es un conflicto de fusión en Git y cómo lo resolví.
Pon a prueba lo que has entendido
Clonas un repositorio vacío de GitHub, haces tu primer commit y git status dice que upstream ha desaparecido. ¿Qué es lo correcto?
Resumen rápido
“Upstream ha desaparecido” significa que tu rama local sigue a una rama remota que no existe. Si acabas de clonar un repositorio vacío, es lo normal hasta tu primer git push -u origin main, que crea la rama en GitHub y deja la conexión configurada. git branch --unset-upstream solo tiene sentido cuando la rama remota se borró a propósito. Y si el push te da problemas de autenticación, una clave SSH lo soluciona de una vez.