Neste laboratório, você aprenderá a lidar com um cenário comum do Git: quando seu branch local está adiantado em relação ao repositório remoto. Essa situação ocorre quando você faz commits localmente, mas ainda não os enviou (push) para o repositório remoto. Ao final deste laboratório, você entenderá como identificar quando seu branch está adiantado em relação ao remoto e como sincronizar seus repositórios local e remoto corretamente.
Nesta etapa, você fará alterações no seu repositório local que ainda não foram enviadas (pushed) para o repositório remoto, criando o cenário de "adiantado em relação ao origin" (ahead of origin).
Primeiro, precisamos configurar um repositório com o qual possamos trabalhar. Usaremos o repositório git-playground como nosso ponto de partida. Como você precisa de permissões de push para completar este laboratório, você precisará criar um fork do repositório primeiro.
Agora, vamos clonar seu repositório forkado para sua máquina local. Substitua YOUR_USERNAME pelo seu nome de usuário real do GitHub:
cd ~/project
git clone https://github.com/YOUR_USERNAME/git-playground.git
cd git-playgroundApós clonar, verifique se o repositório remoto está configurado corretamente:
git remote -vVocê deverá ver uma saída mostrando seu repositório forkado como o remote origin:
origin https://github.com/YOUR_USERNAME/git-playground.git (fetch)
origin https://github.com/YOUR_USERNAME/git-playground.git (push)O Git opera com um modelo distribuído onde cada desenvolvedor tem uma cópia completa do repositório em sua máquina local. As alterações feitas localmente precisam ser sincronizadas explicitamente com o repositório remoto.
Agora, vamos verificar o status atual do nosso repositório:
git statusVocê deverá ver uma saída semelhante a esta:
On branch master
Your branch is up to date with 'origin/master'.
nothing to commit, working tree cleanIsso significa que seu repositório local está atualmente sincronizado com o repositório remoto.
Vamos criar um novo arquivo em nosso repositório:
echo "This is a new file for our project." > new_file.txtApós criar o arquivo, precisamos adicioná-lo à área de staging (staging area) do Git:
git add new_file.txtAgora, vamos commitar este arquivo para o nosso repositório local:
git commit -m "Add new_file.txt"Você deverá ver uma saída confirmando seu commit:
[master 1a2b3c4] Add new_file.txt
1 file changed, 1 insertion(+)
create mode 100644 new_file.txtAgora que fizemos um commit local, vamos verificar o status do nosso repositório novamente:
git statusDesta vez, você deverá ver:
On branch master
Your branch is ahead of 'origin/master' by 1 commit.
(use "git push" to publish your local commits)
nothing to commit, working tree cleanEsta mensagem indica que seu branch local tem um commit que ainda não foi enviado para o repositório remoto. Esta é exatamente a situação que queríamos criar - seu branch agora está "adiantado em relação ao origin".
Agora que seu branch local está adiantado em relação ao branch remoto, vamos explorar como visualizar as diferenças específicas entre seus branches local e remoto.
No Git, você se refere ao branch remoto usando o formato origin/nome-do-branch. O termo origin é o nome padrão para o repositório remoto, e nome-do-branch é o nome do branch (no nosso caso, é master).
Para ver os commits que existem no seu branch local, mas não no branch remoto, use o seguinte comando:
git log origin/master..HEADA saída mostrará o(s) commit(s) que estão no seu branch local (HEAD), mas não no branch remoto (origin/master):
commit 1a2b3c4d... (HEAD -> master)
Author: LabEx User <labex@example.com>
Date: ...
Add new_file.txtPara ver quais arquivos diferem entre seus branches local e remoto, use:
git diff --name-status origin/master..HEADA saída deve mostrar:
A new_file.txtIsso indica que new_file.txt foi adicionado no seu branch local, mas não existe no branch remoto.
Para ver as diferenças reais de conteúdo, você pode usar:
git diff origin/master..HEADIsso mostrará as alterações específicas feitas em cada arquivo:
diff --git a/new_file.txt b/new_file.txt
new file mode 100644
index 0000000..3b2aed8
--- /dev/null
+++ b/new_file.txt
@@ -0,0 +1 @@
+This is a new file for our project.Estes comandos ajudam você a entender exatamente quais alterações estão no seu branch local que ainda não foram enviadas (pushed) para o repositório remoto.
Agora que você entendeu quais alterações estão presentes no seu branch local, é hora de sincronizar seu repositório local com o repositório remoto enviando suas alterações.
O comando git push envia seus commits locais para o repositório remoto. Ao fazer o push, você sincroniza o branch remoto com seu branch local, tornando ambos os branches idênticos.
Para enviar seus commits locais para o repositório remoto, use:
git push origin masterVocê deverá ver uma saída semelhante a esta:
Enumerating objects: 4, done.
Counting objects: 100% (4/4), done.
Delta compression using up to 2 threads
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 324 bytes | 324.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
To https://github.com/YOUR_USERNAME/git-playground.git
abcd123..1a2b3c4 master -> masterA saída mostra:
master -> master)Vamos verificar o status do nosso repositório novamente:
git statusAgora você deverá ver:
On branch master
Your branch is up to date with 'origin/master'.
nothing to commit, working tree cleanIsso confirma que seu branch local agora está sincronizado com o branch remoto. A mensagem "ahead of origin" desapareceu porque ambos os branches agora contêm os mesmos commits.
Podemos verificar se nossas alterações estão agora no repositório remoto examinando o log do branch remoto:
git log origin/master -1Este comando mostra o commit mais recente no branch remoto, que agora deve incluir nosso novo arquivo:
commit 1a2b3c4d... (HEAD -> master, origin/master)
Author: LabEx User <labex@example.com>
Date: ...
Add new_file.txtNote que tanto HEAD -> master quanto origin/master apontam para o mesmo commit agora, confirmando que ambos os branches estão sincronizados.
Em cenários do mundo real, você pode ter múltiplos commits adiantados em relação ao seu branch remoto. Vamos criar essa situação e aprender como resolvê-la.
Vamos criar e commitar várias alterações:
## Create a second file
echo "This is the second file." > second_file.txt
git add second_file.txt
git commit -m "Add second_file.txt"
## Modify the README
echo "### Additional Information" >> README.md
echo "This project demonstrates Git branch synchronization." >> README.md
git add README.md
git commit -m "Update README with additional information"Agora vamos verificar nosso status:
git statusVocê deverá ver:
On branch master
Your branch is ahead of 'origin/master' by 2 commits.
(use "git push" to publish your local commits)
nothing to commit, working tree cleanVamos ver quais commits temos localmente que não estão no remoto:
git log origin/master..HEAD --onelineVocê deverá ver seus dois novos commits:
abcd123 Update README with additional information
efgh456 Add second_file.txtPara sincronizar todos os seus commits locais com o repositório remoto, use o mesmo comando de push:
git push origin masterA saída mostrará ambos os commits sendo enviados (pushed):
Enumerating objects: 7, done.
Counting objects: 100% (7/7), done.
Delta compression using up to 2 threads
Compressing objects: 100% (4/4), done.
Writing objects: 100% (5/5), 574 bytes | 574.00 KiB/s, done.
Total 5 (delta 1), reused 0 (delta 0), pack-reused 0
To https://github.com/YOUR_USERNAME/git-playground.git
1a2b3c4..abcd123 master -> masterVamos verificar nosso status novamente:
git statusVocê deverá ver:
On branch master
Your branch is up to date with 'origin/master'.
nothing to commit, working tree cleanIsso confirma que todos os seus commits locais foram enviados com sucesso para o repositório remoto.
Neste laboratório (lab), você aprendeu a lidar com situações em que seu branch Git local está adiantado em relação ao branch remoto. Você realizou com sucesso:
Essas habilidades são essenciais para o fluxo de trabalho diário do Git, pois ajudam você a manter seus repositórios local e remoto sincronizados, o que é crucial para uma colaboração eficaz em projetos de desenvolvimento de software. Lembre-se de que manter seus branches sincronizados regularmente ajuda a prevenir conflitos e torna a colaboração mais tranquila.
