¿Qué hace exactamente la "u"? "Git push -u origin master" vs "git push origin master"

Aparentemente soy terrible al usar git, a pesar de mis mejores intentos de entenderlo.

De kernel.org para git push:

-u

--set-upstream

Para cada rama que esté actualizada o que se haya enviado correctamente, agregue una referencia ascendente (seguimiento), utilizada por git-pull (1) sin argumentos y otros comandos. Para obtener más información, consulte branch.<name>.mergeen git-config (1).

Aquí viene branch.<name>.mergede git config:

branch.<name>.merge

Define, junto con branch.<name>.remote, la rama ascendente para la rama dada. Le dice a git fetch / git pull qué rama fusionar y también puede afectar a git push (ver push.default). Cuando está en la rama <name>, le dice a git fetch que la especificación de referencia predeterminada se marque para fusionarse en FETCH_HEAD. El valor se maneja como la parte remota de una especificación de referencia y debe coincidir con una referencia que se obtiene del control remoto proporcionado por "branch.<name>.remote". La información de fusión es utilizada por git pull (que al principio llama a git fetch) para buscar la rama predeterminada para la fusión. Sin esta opción, los valores predeterminados de git pull para fusionar la primera refspec obtenida. Especifique múltiples valores para obtener una fusión de pulpo. Si desea configurar git pull para que se fusione con <name>otra rama en el repositorio local, puede apuntarbranch.<name>.mergea la rama deseada, y use la configuración especial. (un punto) para branch.<name>.remote.

Configuré con éxito un repositorio remoto con github, y empujé con éxito mi primer compromiso con:

git push -u origin master

Luego, sin saberlo, empujé con éxito mi segundo commit a mi repositorio remoto usando:

git commit -m '[...]'

Sin embargo, pensando erróneamente que tendría que empujar de nuevo a originpartir master, me encontré:

# note: no -u
git push origin master

¿Qué hizo eso? No parecía tener ningún efecto en absoluto. ¿"Deshacer" git push -u origin master?

La clave es "argumento sin argumento". Cuando haces una git pulldesde una rama, sin especificar una fuente remota o rama, git mira la branch.<name>.mergeconfiguración para saber de dónde sacarla. git push -uestablece esta información para la rama que está presionando.

Para ver la diferencia, usemos una nueva rama vacía:

$ git checkout -b test

Primero, empujamos sin -u:

$ git push origin test
$ git pull
You asked me to pull without telling me which branch you
want to merge with, and 'branch.test.merge' in
your configuration file does not tell me, either. Please
specify which branch you want to use on the command line and
try again (e.g. 'git pull <repository> <refspec>').
See git-pull(1) for details.

If you often merge with the same branch, you may want to
use something like the following in your configuration file:

    [branch "test"]
    remote = <nickname>
    merge = <remote-ref>

    [remote "<nickname>"]
    url = <url>
    fetch = <refspec>

See git-config(1) for details.

Ahora si agregamos -u:

$ git push -u origin test
Branch test set up to track remote branch test from origin.
Everything up-to-date
$ git pull
Already up-to-date.

Tenga en cuenta que la información de seguimiento se ha configurado para que git pullfuncione como se espera sin especificar el control remoto o la sucursal.

Actualización: consejos de bonificación:

• Como Mark menciona en un comentario, además de git pullesta configuración también afecta el comportamiento predeterminado de git push. Si tiene la costumbre de usar -upara capturar la rama remota que desea rastrear, le recomiendo configurar su push.defaultvalor de configuración en upstream.
• git push -u <remote> HEADempujará la rama actual a una rama del mismo nombre <remote>(y también configurará el seguimiento para que pueda hacerlo git pushdespués de eso).

git push -u origin master

… es lo mismo que:

git push origin master ; git branch --set-upstream master origin/master

Haga la última declaración, si olvida el -u!

O podrías forzarlo:

git config branch.master.remote origin
git config branch.master.merge refs/heads/master

Si deja que el comando lo haga por usted, seleccionará sus errores, como si escribió una rama inexistente o no lo hizo git remote add; aunque eso podría ser lo que quieres. :)

En términos más simples:

Técnicamente, el -uindicador agrega una referencia de seguimiento al servidor ascendente al que está presionando.

Lo importante aquí es que esto le permite hacer una git pullsin proporcionar más argumentos. Por ejemplo, una vez que haces un git push -u origin master, puedes llamar más tarde git pully git sabrá que realmente quisiste decir git pull origin master.

De lo contrario, tendría que escribir todo el comando.

Todos los comandos necesarios de git bash para empujar y tirar en Github:

git status 
git pull
git add filefullpath

git commit -m "comments for checkin file" 
git push origin branch/master
git remote -v 
git log -2 

Si desea editar un archivo, entonces:

edit filename.* 

Para ver todas las ramas y sus commits:

git show-branch