Cómo configurar una rama ascendente en Git

Para impulsar una nueva rama y configurar su flujo ascendente, ejecute `git push -u origin my-branch`. Si la rama ya existe en el remoto, ejecute git branch -u origin/my-branch en su lugar. Después de eso, git push y git pull saben adónde ir. -u es la abreviatura de --set-upstream.

¿Qué es una rama ascendente en Git?

La upstream, también llamada rama de seguimiento, es la rama remota vinculada a la local. Git usa ese enlace para tres cosas: dónde van git pull y git push sin argumentos, con qué cuentan los adelante y atrás en git status en comparación y qué significa la abreviatura @{u}.

¿Cómo configuro el upstream para una nueva rama?

git switch -c feature/search
git push -u origin feature/search

Esto crea la rama en el remoto y vincula los dos. Solo necesitas -u en el primer intento. La guía para crear y cambiar ramas cubre el paso anterior a este.

¿Cómo configuro el upstream para una rama existente?

Cuando la rama remota ya exista, vincúlala sin presionar:

# the branch you are on
git branch -u origin/feature/search

# any other branch
git branch -u origin/main main

La forma larga es git branch --set-upstream-to=origin/main. Si Git dice que la rama remota no existe, ejecute git fetch primero.

¿Cómo soluciono "La rama actual no tiene una rama ascendente"?

Git imprime esto cuando ejecutas git push en una rama que nunca ha sido enviada:

fatal: The current branch feature/search has no upstream branch.
To push the current branch and set the remote as upstream, use

    git push --set-upstream origin feature/search

Ejecute el comando que sugiere. Para dejar de ver el error, haga que Git haga esto cada vez que presione por primera vez (Git 2.37 o posterior):

git config --global push.autoSetupRemote true

El mensaje relacionado "No hay información de seguimiento para la rama actual" proviene de git pull. La solución es la misma: git branch -u origin/my-branch.

¿Cómo veo lo que sigue una rama?

# every branch, with its upstream and ahead/behind
git branch -vv

# only the current branch
git rev-parse --abbrev-ref @{u}

# commits you have not pushed
git log @{u}..

# commits you have not pulled
git log ..@{u}

¿Cómo cambio o elimino un upstream?

# point the branch somewhere else
git branch -u origin/develop

# stop tracking anything
git branch --unset-upstream

Ningún comando cambia ninguna confirmación. Solo editan la configuración de la rama en .git/config.

¿Qué significa aguas arriba en una bifurcación?

La palabra tiene un segundo significado. En una bifurcación, upstream es por convención el nombre de un remoto: el proyecto original del que bifurcaste, mientras que origin es tu propia copia. De eso se trata “git remoto add upstream”:

git remote add upstream https://github.com/original/project.git
git fetch upstream
git switch main
git merge upstream/main
git push origin main

Consulte establecer seguimiento y publicar una rama para obtener más detalles y la lección remota y ascendente para practicar.