Git Push Set Upstream

Este tutorial nos ensinará a configurar branches upstream no Git enquanto fazemos um git push.

Ramificações upstream são as ramificações no repositório remoto que são rastreadas por uma ramificação remota local no repositório local. Essas ramificações remotas locais também são chamadas de ramificações de rastreamento remoto.

Quando criamos um branch no Git, teremos que configurar um branch upstream para funcionar corretamente. Vamos agora ilustrar isso com um exemplo.

Usando git Push para configurar o Upstream Branch no Git

Suponha que criamos um branch viz. feature1 para algum desenvolvimento de recursos abaixo.

$ git checkout -b feature1
Switched to a new branch 'feature1'

Iremos agora verificar os ramos de rastreamento usando o comando git branch com a opção -vv.

$ git branch -vv
* feature1  741a786 Initial commit
 main  741a786 [origin/main] Initial commit

Podemos ver que a ramificação main possui uma ramificação de rastreamento e uma ramificação upstream associada a ela. Em comparação, o branch feature1 que acabamos de criar não tem nenhum branch de rastreamento e nenhum branch upstream associado a ele.

Assim, agora iremos configurar o branch upstream usando o comando git push com a opção --set-upstream.

$ git push --set-upstream origin feature1
Total 0 (delta 0), reused 0 (delta 0)
 * [new branch]      feature1 -> feature1
Branch 'feature1' set up to track remote branch 'feature1' from 'origin'.

Verificaremos os ramos de rastreamento de ambos os ramos novamente, como segue.

$ git branch -vv
* feature1  741a786 [origin/branch] Initial commit
main  741a786 [origin/main] Initial commit

Podemos ver que ambos os ramos viz. feature1 e main possuem branches upstream definidos.

A configuração de branches upstream no Git é conveniente porque quando alguém faz um git fetch, novos commits do repositório remoto podem ser obtidos, e então pode-se escolher mesclar essas mudanças.

Outro uso é que quando alguém faz um git pull (para obter alterações de repositório remoto) ou git push (para enviar alterações para o repositório remoto), não é mais necessário fornecer o branch de destino nesses comandos.

Por exemplo, pode-se executar o seguinte para enviar as novas alterações para o repositório remoto.

$ git push

Explore o seguinte site para obter mais informações sobre o comando git push e as opções disponíveis - git push.