Como Verificar se um Branch Git Está Rastreando um Branch Remoto

Introdução

Neste laboratório, você aprenderá como verificar se um branch Git local está rastreando um branch remoto. Exploraremos dois métodos principais: usar o comando git branch -vv para ver rapidamente as informações de rastreamento e usar o comando git config para verificar a configuração upstream.

Através de exemplos práticos, você entenderá como interpretar a saída desses comandos e identificar a qual branch remoto seu branch local está conectado, se houver. Também abordaremos brevemente o conceito de branches não rastreados.

Executar git branch -vv para Verificar o Rastreamento

Nesta etapa, aprenderemos como verificar o status de rastreamento de seus branches locais usando o comando git branch -vv. Este comando é muito útil para ver a qual branch remoto seu branch local está conectado, se houver.

Primeiro, vamos garantir que estamos no diretório do nosso projeto. Abra seu terminal e navegue até o diretório my-time-machine:

cd ~/project/my-time-machine

Agora, execute o comando git branch -vv:

git branch -vv

Você deve ver uma saída semelhante a esta:

* master a1b2c3d [origin/master] Send a message to the future

Vamos analisar essa saída:

• * master: O asterisco (*) indica que master é seu branch ativo atual.
• a1b2c3d: Esta é a versão abreviada do hash do último commit neste branch.
• [origin/master]: Esta parte informa que seu branch master local está rastreando o branch master em um repositório remoto chamado origin. Ainda não adicionamos um remoto, mas o Git está mostrando as informações de rastreamento potenciais.
• Send a message to the future: Esta é a mensagem de commit do último commit neste branch.

Entender o rastreamento de branches é importante, especialmente quando você começa a colaborar com outras pessoas ou a enviar seu código para plataformas como o GitHub. Isso ajuda você a saber se seu branch local está atualizado com a versão remota e para onde suas alterações irão quando você as enviar.

Nas próximas etapas, exploraremos como configurar e verificar branches upstream, que é o branch remoto que seu branch local rastreia.

Usar git config para Verificar Upstream

Na etapa anterior, vimos que git branch -vv mostrou [origin/master]. Isso indica que nosso branch master local está configurado para rastrear o branch master em um remoto chamado origin. Embora ainda não tenhamos adicionado um remoto, o Git possui configurações padrão que sugerem essa relação de rastreamento.

Podemos verificar essa configuração usando o comando git config. Este comando nos permite visualizar e modificar as configurações do Git.

Certifique-se de que você ainda está no diretório ~/project/my-time-machine.

Agora, vamos verificar a configuração do remoto do nosso branch master:

git config branch.master.remote

Este comando pergunta especificamente ao Git o valor da configuração remote para o branch master.

Você deve ver a saída:

origin

Isso confirma que o branch master está configurado para usar origin como seu remoto.

Em seguida, vamos verificar a configuração do nome do branch remoto que nosso branch master local rastreia:

git config branch.master.merge

Este comando pergunta ao Git o valor da configuração merge para o branch master, que especifica o branch remoto a ser mesclado no branch local.

Você deve ver a saída:

refs/heads/master

Isso confirma que o branch master está configurado para rastrear o branch master no remoto. refs/heads/master é o nome de referência completo para o branch master.

Usar git config é uma maneira poderosa de entender e gerenciar as configurações detalhadas do seu repositório Git, incluindo como seus branches locais interagem com repositórios remotos.

Testar Branches Sem Rastreamento

Nas etapas anteriores, vimos como nosso branch master está configurado para rastrear um branch remoto. Agora, vamos criar um novo branch local que não rastreia um branch remoto e ver como git branch -vv relata seu status.

Certifique-se de que você ainda está no diretório ~/project/my-time-machine.

Primeiro, vamos criar um novo branch chamado experiment:

git branch experiment

Este comando cria um novo branch chamado experiment, mas não muda para ele.

Agora, vamos executar git branch -vv novamente para ver o status de todos os nossos branches locais:

git branch -vv

Você deve ver uma saída semelhante a esta:

* master    a1b2c3d [origin/master] Send a message to the future
  experiment a1b2c3d Send a message to the future

Observe a diferença na saída para o branch experiment em comparação com o branch master. O branch experiment não mostra [origin/...] após o hash do commit. Isso indica que o branch experiment é um branch local que não está atualmente rastreando nenhum branch remoto.

Este é um cenário comum quando você cria um novo branch local para experimentação ou para desenvolver um novo recurso antes de decidir compartilhá-lo com outras pessoas em um repositório remoto.

Você pode definir explicitamente um branch upstream para um branch local usando git branch --set-upstream-to=<remote>/<remote-branch> <local-branch>. No entanto, por enquanto, é importante entender que nem todos os branches locais rastreiam automaticamente um branch remoto.

Isso conclui nossa exploração da verificação do status de rastreamento de branches. Você aprendeu como usar git branch -vv e git config para entender como seus branches locais são configurados para interagir com remotos.

Resumo

Neste laboratório, aprendemos como verificar se um branch Git está rastreando um branch remoto. Usamos o comando git branch -vv para ver o status de rastreamento dos branches locais, identificando o branch remoto e o repositório que estão sendo rastreados.

Também exploramos como usar o comando git config para verificar a configuração upstream (a montante) de um branch, confirmando o branch remoto que um branch local está configurado para rastrear. Finalmente, testamos o comportamento de branches não rastreáveis para entender como o Git lida com branches sem uma configuração upstream explícita.