Introdução

É sabido que, para começar a desenvolver um projeto, a tecnologia GIT nos ajuda bastante. Nessa tecnologia, há uma série de comandos que nos auxiliam quando trata-se de comunicação entre repositórios da plataforma GitHub, diretamente de nosso terminal ou da Interface Integrada de Desenvolvimento - IDE.

Dentro desse leque de comandos que compõem o GIT, há um comando chamado GIT Pull. O GIT Pull é um comando poderoso que combina as funcionalidades dos comandos GIT Fetch e GIT Merge.

Para que é usado

O comando GIT Pull é usado para baixar as últimas alterações do repositório remoto (repositório online do perfil GitHub) e mesclá-las com o seu repositório local (repositório criado no disco rígido de sua máquina).

Quando usar

Devemos usar o comando GIT Pull quando precisarmos atualizar o nosso repositório local com as últimas alterações do repositório remoto - isso é especialmente importante se você estiver trabalhando em um projeto colaborativo, onde outros membros da equipe estão constantemente fazendo alterações no repositório remoto; E também pode ser usado para mesclar as alterações de outras branches na sua branch atual - caso você esteja trabalhando em uma branch específica e deseje incorporar as alterações de outra branch na sua branch.

Como usar

A sintaxe de utilização do comando GIT Pull é a seguinte:

Fonte: <https://git-scm.com/docs/git-pull>

Onde <options> são as operações do comando; <repository> é o repositório remoto; e <refspec> é uma referência do repositório remoto (tag).

Para utilizar-se do comando GIT Pull é necessário a integração do seu repositório local com o repositório remoto. Caso já feita a integração, siga as seguintes instruções:

1. Navegue para o diretório do seu repositório local;
2. Verifique se o repositório em trabalho é aquele que você deseja atualizar;
3. Execute o comando com a seguinte sintaxe:

git pull origin <nome_da_branch>

Onde: origin é o nome do repositório remoto e <nome_da_branch> é o nome da branch que está sendo trabalhada.

Exemplo prático

Imagina-se que você está trabalhando em um projeto colaborativo. No primeiro dia, caso a equipe já esteja avançada no projeto, é de seu interesse atualizar a branch master do seu repositório local com as últimas alterações da branch master do repositório remoto. Inicialmente, deve-se realizar os 3 passos destacados acima e detalhados abaixo:

1 - Abra o seu terminal e navegue até o diretório do seu projeto, caso já tenha criado;

cd my-project

2 - Verifique se a brach em trabalho é a que você deseja atualizar;

git branch

3 - Execute o comando;

git pull origin master

4 - Caso hajam conflitos de mesclagem, você precisa resolvê-los manualmente para concluir o fluxo do comando com êxito.

Após a execução do comando, o GIT faz o seguinte:

1. Baixa as alterações do repositório remoto para o seu repositório local;
2. Mescla as alterações da branch remota com a sua branch local.
3. Caso haja conflitos de mesclagem, o terminal os destaca para você (Faz-se necessário a resolução dos conflitos de mesclagem para finalização correta do comando).

Antes da execução do comando, o ramo encontra-se da seguinte maneira:

Fonte: <https://git-scm.com/docs/git-pull>

Depois da execução do comando, o ramo encontra-se da seguinte maneira:

Fonte: <https://git-scm.com/docs/git-pull>

Nota-se que, após a execução do comando, é realizada uma busca e reprodução das alterações do último commit da branch remota origin/master (C) desde que ela divergiu da branch local master até seu commit atual (G), em seguida, registra o resultado em um novo commit da branch master local (H) com os nomes dos dois commit's pais e uma mensagem de log do usuários descrevendo as alterações.

Algumas operações do comando GIT Pull estão listadas a seguir:

• -f: Força a mesclagem, mesmo que haja conflitos;
• --rebase: Rebasea a sua branch local na branch remota;
• --no-ff: Cria um novo commit de mesclagem.

Informações importantes

• O comando GIT Pull pode ser perigoso, se você não o usar com cuidado;
• Antes de usar o comando GIT Pull, certifique-se de que você fez backup do seu repositório local.

Salienta-se a importância da consulta à documentação do comando, cuja pode ser encontrada oficialmente no link a seguir: <https://git-scm.com/docs/git-pull>