Git: Establecer la rama upstream
Última actualización
El upstream de una rama es la rama remota que rastrea. Una vez establecido, un git push y git pull simples saben a dónde enviar y de dónde traer los commits sin que nombres el remoto y la rama cada vez. Normalmente lo estableces en el primer push con -u, o más tarde con git branch --set-upstream-to.
Prueba estos comandos en el terminal playground - una shell real en tu navegador, sin nada que instalar.
Sintaxis
| Command | What it does |
|---|---|
git push -u origin feature | Hace push y establece el upstream en un solo paso |
git branch --set-upstream-to=origin/feature | Establece el upstream para la rama actual |
git branch -u origin/feature feature | Establece el upstream para una rama con nombre |
git branch -vv | Muestra cada rama y su upstream |
Casos comunes
| Goal | Command |
|---|---|
| Establecer el upstream en el primer push | git push -u origin feature |
| Establecer el upstream para una rama existente | git branch --set-upstream-to=origin/feature |
| Comprobar qué upstream está establecido | git branch -vv |
Preguntas frecuentes sobre git set upstream
¿Qué hace establecer la rama upstream?
Vincula tu rama local con una rama remota específica. Después de eso,
git push y git pull en esa rama saben qué remoto y rama usar, así que puedes ejecutarlos sin argumentos. Git también muestra cuánto estás por delante o por detrás del upstream en git status.¿Cómo establezco la rama upstream?
La forma más fácil es en el primer push:
git push -u origin <branch> hace push y establece el upstream a la vez. Para una rama que ya existe en el remoto, usa git branch --set-upstream-to=origin/<branch> estando en esa rama.¿Cómo veo el upstream de una rama?
Ejecuta
git branch -vv. Lista tus ramas locales, cada una anotada con su upstream (como [origin/feature]) y si está por delante o por detrás. Las ramas sin upstream no muestran nada entre corchetes.¿Por qué git push me pide que establezca el upstream?
Porque la rama actual no tiene un upstream configurado, así que Git no sabe a dónde hacer push. Ejecuta
git push -u origin <branch> una vez para establecerlo; los pushes posteriores solo necesitan git push.¿Puedo practicar esto en línea?
Sí. Abre el terminal playground para ejecutar estos comandos en una shell real en tu navegador - sin nada que instalar. El curso interactivo y gratuito de Git de Coddy también cubre el trabajo con remotos paso a paso.
Recursos relacionados
Más comandos de Git
