Descrever a fonte interna com garfos
As pessoas bifurcam repositórios quando querem alterar o código em um repositório ao qual não precisam escrever acesso.
Se você não tem acesso de gravação, você não faz parte da equipe que contribui para esse repositório, então por que você modificaria o repositório de código?
Tendemos a procurar razões técnicas para melhorar algo no nosso trabalho.
Você pode encontrar uma maneira melhor de implementar a solução ou melhorar a funcionalidade contribuindo ou melhorando um recurso existente.
Você pode bifurcar repositórios nas seguintes situações:
- Quero fazer uma mudança.
- Acho que o projeto é empolgante e talvez queira usá-lo.
- Quero usar algum código nesse repositório como ponto de partida para o meu projeto.
As equipas de software são incentivadas a contribuir para todos os projetos internamente, não apenas para os seus projetos de software.
Os garfos são uma ótima maneira de promover uma cultura de código aberto interno.
As bifurcações são uma adição recente aos repositórios Git do Azure DevOps.
Esta receita irá ensiná-lo a bifurcar um repositório existente e contribuir com alterações a montante através de um pull request.
Preparação
Uma bifurcação começa com todo o conteúdo do seu repositório upstream (original).
Ao criar uma bifurcação no Azure DevOps, você pode incluir todas as ramificações ou limitá-las apenas à ramificação padrão.
Uma bifurcação não copia as permissões, políticas ou definições de compilação do repositório que está sendo bifurcado.
Depois que uma bifurcação é criada, os arquivos, pastas e ramificações recém-criados não são compartilhados entre os repositórios, a menos que você inicie uma solicitação pull.
As solicitações pull são suportadas em qualquer direção: da bifurcação para o upstream ou do upstream para o fork.
A abordagem mais comum para uma solicitação pull será da bifurcação para o upstream.
Como fazê-lo
Escolha o botão Garfo (1) e, em seguida, selecione o projeto onde pretende que a bifurcação seja criada (2). Dê um nome ao garfo e escolha o botão Garfo (3).
Quando a bifurcação estiver pronta, clone-a usando a linha de comando ou um IDE, como o Visual Studio. O garfo será o seu controle remoto de origem. Por conveniência, você desejará adicionar o repositório upstream (de onde você se bifurcou) como um controle remoto chamado upstream. Na linha de comando, digite:
git remote add upstream {upstream_url}É possível trabalhar diretamente no principal – este garfo é a sua cópia do repo. No entanto, recomendamos que você ainda trabalhe em um ramo tópico. Ele permite que você mantenha vários fluxos de trabalho independentes simultaneamente. Além disso, reduz a confusão mais tarde quando você deseja sincronizar as alterações na bifurcação. Faça e confirme as alterações como faria normalmente. Quando terminar as modificações, empurre-as para a origem (o garfo).
Abra um pull request da sua bifurcação para o upstream. O repositório upstream aplicará todas as políticas necessárias para revisores e compilações. Uma vez satisfeitas todas as políticas, o PR pode ser concluído e as alterações tornam-se uma parte permanente do repositório a montante:
Quando seu PR for aceito a montante, você deve garantir que sua bifurcação reflita o estado de recompra mais recente. Recomendamos que se baseie novamente no ramo principal do upstream (assumindo que o principal é o ramo de desenvolvimento principal). Na linha de comando, execute:
git fetch upstream main git rebase upstream/main git push origin
Para obter mais informações sobre o Git, consulte:
- Clone um repositório Git existente.
- Tutorial do Azure Repos Git.