Sobre branches

O que são branches?

Os branches podem ser usados para:

• Desenvolver recursos
• Corrigir erros
• Testar novas ideias com segurança

Você sempre cria um branch a partir de um branch existente. Normalmente, você pode criar um branch a partir do branch mestredo seu repositório. Você então poderá trabalhar nesse novo branch isolado das mudanças que outras pessoas estão fazendo no repositório. Um branch que você cria para produzir um recurso é comumente referido como um branch de recurso ou branch de tópico. Para obter mais informações, consulte "Criar e excluir branches em seu repositório".

Também é possível usar um branch para publicar um site do GitHub Pages. Para obter mais informações, consulte "O que é GitHub Pages?"

Você deve ter acesso de gravação em um repositório para criar um branch, abrir uma pull request ou excluir e restaurar branches em uma pull request. Nos repositórios em que você tem acesso de proprietário ou administrador, é possível alterar o branch padrão. Para obter mais informações, consulte "Permissões de acesso no GitHub Enterprise" e "Gerenciar branches em seu repositório".

Trabalhando com branches

Quando estiver satisfeito com seu trabalho, você poderá abrir uma pull request para fazer merge das alterações do branch atual (o branch head) com outro branch (o branch base). Para obter mais informações, consulte "Sobre pull requests".

Depois que uma pull request tiver sido mesclada ou fechada, você poderá excluir o branch head, já que isso não é mais necessário. Você deve ter permissão de gravação no repositório para excluir branches. Não é possível excluir branches associados diretamente a pull requests abertas. Para obter mais informações, consulte "Excluindo e recuperando branches em uma pull request".

Trabalhar com branches protegidos

Os administradores de repositório podem habilitar proteções em um branch. Se estiver trabalhando em um branch que é protegido, não será possível excluir nem forçar o push no branch. Os administradores do repositório podem habilitar, de modo adicional, várias outras configurações de branch protegido para aplicar vários fluxos de trabalho antes que um branch passe por um merge.

Para verificar se é possível fazer merge de uma pull request, observe a caixa de merge na parte inferior da guia Conversation (Conversa) da pull request. Para obter mais informações, consulte "Sobre branches protegidos".

Quando um branch estiver protegido:

• Você não poderá excluir nem fazer um push forçado no branch.
• Se as verificações de status obrigatórias forem habilitadas no branch, não será possível fazer merge das alterações no branch até que todos os testes de CI obrigatórios sejam aprovados. Para obter mais informações, consulte "Sobre verificações de status".
• Se as revisões obrigatórias de pull request forem habilitadas no branch, não será possível fazer merge de alterações no branch até que todos os requisitos na política da revisão de pull request tenham sido atendidos. Para obter mais informações, consulte "Fazer merge de uma pull request".
• Se a revisão obrigatória de um proprietário do código for habilitada em um branch, e uma pull request modificar o código que tem um proprietário, um proprietário do código deverá aprovar a pull request para que ela possa passar por merge. Para obter mais informações, consulte "Sobre proprietários do código".
• Se a assinatura de commit obrigatória for habilitada em um branch, não será possível fazer push de qualquer commit no branch que não esteja assinado e verificado. Para obter mais informações, consulte "Sobre a verificação da assinatura de commit" e "Sobre a assinatura de commit obrigatória".

Leia mais

• "Sobre pull requests"
• "Branch" no glossário do GitHub
• "Branches em um Nutshell" na documentação do Git