Aprenda a fazer branches com o Bitbucket Cloud
Objetivo
Este tutorial ensina os passos básicos para criar, analisar, mesclar e trabalhar em branches a partir do Git e do Bitbucket Cloud.
Tempo | Público-alvo: | Pré-requisitos |
---|---|---|
35 minutos | Você já entende o fluxo de trabalho básico do Git | Você instalou o Git |
Você tem uma conta Bitbucket |
Este tutorial é para pessoas que já conhecem o fluxo de trabalho básico do Git, incluindo como:
- Clonar: copiar o repositório remoto no Bitbucket Cloud para o sistema local
- Adicionar ou preparar: pegar as alterações que você fez e as preparar para adicionar ao histórico do Git
- Commit: adicionar arquivos novos ou modificados ao histórico do Git para o repositório
- Enviar pull: ver novas alterações que outros adicionaram ao repositório no seu repositório local
- Push: obter alterações de seu sistema local no repositório remoto
Se você não conhece os fundamentos do Git, não se preocupe: confira o tutorial Aprenda o Git com Bitbucket Cloud e você vai estar preparado para começar em pouco tempo.
Fique com tudo pronto
Como a gente quer que você sinta que está trabalhando em equipe, em um repositório comum do Bitbucket, a gente pede que você bifurque um repositório público que a gente já forneceu.
- Acesse tutorials/tutorials.git.bitbucket.org
- Clique em + > Bifurcar este repositório no lado esquerdo da tela.
- Modifique o Nome para que seja exclusivo da equipe e clique em Bifurcar o repositório.
- Crie um diretório para o repositório que seja fácil de navegar. Você pode escolher algo assim:
$ mkdir test-repositories $ cd test-repositories/ $ test-repositories
- Clone o repositório bifurcado no diretório que você acabou de criar. Ele pode se parecer com o seguinte:
$ git clone https://dstevenstest@bitbucket.org/dstevenstest/mygittutorial.bitbucket.io.git Cloning into 'mygittutorial.bitbucket.io'... remote: Counting objects: 12392, done. remote: Compressing objects: 100% (12030/12030), done. remote: Total 12392 (delta 8044), reused 564 (delta 360) Receiving objects: 100% (12392/12392), 2.72 MiB | 701.00 KiB/s, done. Resolving deltas: 100% (8044/8044), done. $ cd mygittutorial.bitbucket.io/
Crie um branch e modifique algo usando o fluxo de trabalho com branches
Você vai adicionar uma cotação ao seu site nesse branch.
- Crie um branch usando o comando git branch.
$ git branch test-1
- Verifique o branch que acabou de criar usando o comando git checkout.
$ git checkout test-1 Switched to branch 'test-1'
- Liste os branches que você tem no local usando o comando git branch.
$ git branch master * test-1
- Faça uma atualização no arquivo editme.html adicionando uma cotação. Você pode usar algo assim:
Esta é uma citação, e eu gosto dela.
Uma citação: a arte de citar - Adicione essa mudança.
git add editme.html
- Faça o commit da alteração com uma mensagem de commit descritiva.
git commit editme.html -m'adicionou uma nova citação' [test-1 063b772] adicionou uma nova citação 1 arquivo alterado, 3 inserções(+), 3 exclusões(-)
- Envie essa alteração para o Bitbucket usando o comando git push.
git push fatal: A ramificação atual test-1 não tem ramificação upstream. Para enviar a ramificação atual e definir o controle remoto como upstream, use git push --set-upstream origin test-1
- Envie a ramificação e mude usando o comando git push branch.
$ git push origin test-1 Contando objetos: 3, pronto. Compressão delta usando até 8 threads. Comprimindo objetos: 100% (3/3), pronto. Gravando objetos: 100% (3/3), 363 bytes | 0 bytes/s, pronto. Total 3 (delta 2), reutilizado 0 (delta 0) remoto: remoto: Criar solicitação pull para test-1: remoto: https://bitbucket.org/dstevenstest/dans.git.bitbucket.org/pull-requests/new?source=test-1&t=1 remoto: Para https://bitbucket.org/dstevenstest/dans.git.bitbucket.org.git * [novo branch] test-1 -> test-1
- Abra seu repositório de tutoriais e clique em Branches. Agora você deve ver o branch principal e a ramificação test-1. Você deve ver algo assim:

Crie, capture e verifique um branch remoto
Ao trabalhar em uma equipe, é possível que você tenha que enviar pulls ou buscar branches que outros membros da equipe criam e fazem push no Bitbucket. Este exemplo vai dar a você algumas noções básicas para criar e trabalhar com os branches criados por eles.
- RamificaçõesAcesse o repositório de tutoriais no Bitbucket e clique em Branches. Você deve ver algo assim:
- Clique em Criar ramificação, nomeie a ramificação test-2 e clique em Criar.
- Copie o comando git fetch na janela verificar branch. É provável que ele seja parecido com o seguinte:
$ git fetch && git checkout test-2 From https://bitbucket.org/dstevenstest/dans.git.bitbucket.org * [new branch] test-2 -> origin/test-2 Branch test-2 set up to track remote branch test-2 from origin. Switched to a new branch 'test-2'
- Use o comando git branch no terminal. Você deve ver uma lista de branches assim:
$ git branch master test-1 * test-2
- Use o comando git status e você vai ver algo assim:
$ git status On branch test-2 Your branch is up-to-date with 'origin/test-2'. nothing to commit, working tree clean
- Use o comando de git checkout para mudar o foco de volta para sua outra ramificação. O comando vai ser algo assim:
$ git checkout test-1 Switched to branch 'test-1' Your branch is ahead of 'origin/test-1' by 3 commits. (use "git push" to publish your local commits)
Modifique por push e crie uma solicitação pull
Agora é o momento de fazer com que a primeira alteração seja revisada e mesclada no branch.
- Clique em +> Criar uma solicitação pull. Você pode ver sua ramificação test-1 como a ramificação de origem e o branch principal na ramificação de destino.
- Clique em Criar solicitação pull.
- Faça um comentário na solicitação pull selecionando uma linha na comparação (a área que exibe a alteração que você fez no arquivo editme.html ).
- Clique em Aprovar na parte superior esquerda da página. É óbvio que, em uma solicitação pull real, você teria revisores fazendo comentários
- Clique em Mesclar.
- (Opcional) Atualize a Mensagem de commit com mais informações.
- Selecione a estratégia de merge (mesclagem) Merge commit entre as duas opções:
- Merge commit: mantém todos os commits do branch de origem e os torna parte do branch de destino. Essa opção é o mesmo que digitar git merge --no-ff na linha de comando.
- Squash: combina os commits quando ao mesclar o branch de origem no de destino. Essa opção é o mesmo que digitar git merge --squash na linha de comando.
- Clique em Commits e você vai ver como o branch que acabou de mesclar se encaixa no esquema mais amplo de alterações.
Exclua um branch e envie um pull mestre para o branch de trabalho local
Você passou pelo fluxo de trabalho básico de branch, e a modificação está no principal. A última coisa que a gente vai aprender é a excluir o branch que você acabou de mesclar, enviar o branch principal atualizado por pull e mesclar esse branch no test-2.
- Abra o terminal e execute o comando git status. O resultado deve ser algo assim:
$ git status On branch test-1 nothing to commit, working tree clean
- Mude para o branch principal executando o comando git checkout master. O resultado deve ser algo assim:
git checkout master Switched to branch 'master' Your branch is up-to-date with 'origin/master'.
- Execute o comando git pull. O resultado deve ser algo assim:
$ git pull remote: Counting objects: 1, done. remote: Total 1 (delta 0), reused 0 (delta 0) Unpacking objects: 100% (1/1), done. From https://bitbucket.org/dstevenstest/dans.git.bitbucket.org 2d4c0ab..dd424cb master -> origin/master Updating 2d4c0ab..dd424cb Fast-forward editme.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-)
- Execute o comando git branch -d {branch_name} para remover o branch test-1. O resultado vai ser algo assim:
$ git branch -d test-1 Deleted branch test-1 (was 063b772)
- Mude para o branch test-2 usando o comando git checkout.
$ git checkout test-2 Switched to branch 'test-2' Your branch is up-to-date with 'origin/test-2'.
- Mescle o branch principal e o branch no qual você está trabalhando usando o comando git merge master test-2. O resultado vai ser algo assim:
$ git merge master test-2 Updating 2d4c0ab..dd424cb Fast-forward editme.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-)
- O branch ativo é importante. Se você quer mesclar o branch principal com o test-2, é necessário que o test-2 seja verificado (ativo). A mesma coisa acontece quando você quer mesclar o test-2 com o branch principal: é preciso verificar o branch principal.
- Para ver qual branch está ativo a qualquer momento, use o git branch e o branch ativo vai ter um asterisco, ou use git status e ele vai informar em qual branch você está e se há alterações locais pendentes.
A gente espera que você tenha aprendido um pouco sobre branches e os comandos envolvidos. Vamos revisar alguns conceitos:
Confira o fluxo de trabalho de branch
O fluxo de trabalho de branches de recurso do Git é uma forma eficiente de começar a trabalhar com a equipe no Bitbucket. Nesse fluxo de trabalho, todo o desenvolvimento de recursos ocorre em branches separados do branch principal mestre. Assim, vários desenvolvedores podem trabalhar nos próprios recursos sem encostar no código principal.
![]() | Comece com o branch principalEste fluxo de trabalho ajuda você a colaborar no código com pelo menos outra pessoa. Desde que os repositórios locais e do Bitbucket estejam atualizados, você está pronto para começar. |
Crie um novo branchUse um branch separado para cada recurso ou problema em que você trabalha. Depois de criar um branch, verifique-o no local para que todas as alterações que você fizer sejam nesse branch. | |
Atualizar, adicionar, fazer o commit enviar por push as alteraçõesTrabalhe no recurso e faça commits como faria sempre que usa o Git. Quando estiver pronto, envie os commits, atualizando o branch de recursos no Bitbucket. | |
Faça uma revisão do seu códigoPara obter um retorno sobre seu código, crie uma solicitação pull no Bitbucket. A partir daí, você pode adicionar revisores e garantir que tudo esteja correto antes de mesclar. | |
Resolver FeedbackAgora, seus colegas comentam e aprovam. Resolva os comentários deles no local, confirme e envie as modificações para o Bitbucket. As atualizações aparecem na solicitação pull. | |
Mescle o seu branchAntes de mesclar, talvez seja necessário resolver conflitos de mesclagem se outras pessoas fizerem alterações no repositório. Quando a solicitação pull é aprovada e não tem conflitos, você pode adicionar código ao branch principal. Mesclar a partir da solicitação pull no Bitbucket. |
Este tutorial tem por objetivo mostrar como os branches tornam as equipes mais eficientes. Há diferentes formas de ramificar e a gente vai ver algumas delas em: Como comparar fluxos de trabalho.