Skip to main content

Mesclar uma solicitação de pull

Faça merge de uma pull request no branch upstream quando o trabalho estiver finalizado. Qualquer pessoa com acesso push no repositório pode completar o merge.

Tool navigation

Sobre merges de pull request

Em uma pull request, você propõe que as alterações feitas em um branch head sejam mescladas em um branch base. Por padrão, qualquer pull request pode sofrer merge a qualquer momento, a menos que o branch head esteja em conflito com o branch base. No entanto, pode haver restrições sobre quando você puder fazer merge de um pull request em um branch específico. Por exemplo, você só pode fazer merge de um pull request no branch-padrão se as verificações de status necessárias forem aprovadas. Os administradores do repositório podem adicionar restrições como essa aos branches usando regras de proteção de branch. Para obter mais informações, confira "Sobre branches protegidos".

Como alternativa às regras de proteção de branch, você pode criar conjuntos de regras. Os conjuntos de regras têm algumas vantagens em relação às regras de proteção de branches, como status, e melhor capacidade de detecção sem exigir acesso de administrador. Você também pode aplicar vários conjuntos de regras ao mesmo tempo. Para obter mais informações, confira "Sobre os conjuntos de regras".

Você pode configurar um pull request para fazer merge automaticamente quando todos os requisitos de merge forem atendidos. Para obter mais informações, confira "Fazer merge automático de um pull request".

Se a solicitação de pull tiver conflitos de mesclagem ou se você quiser testar as alterações antes da mesclagem, faça check-out da solicitação de pull localmente e mescle-a usando a linha de comando.

Você não pode realizar o merge de um rascunho de um pull request. Para obter mais informações sobre rascunhos de solicitações de pull, confira "Sobre solicitação de pull".

O repositório pode ser configurado para que o branch principal de um pull request seja excluído automaticamente quando você faz o merge de um pull request. Para obter mais informações, confira "Gerenciar a exclusão automática de branches".

Note

Se você excluir um branch de cabeçalho após o merge do seu pull request, o GitHub irá verificar se há quaisquer solicitações de pull no mesmo repositório que especificam o branch excluído como o branch base. O GitHub atualiza automaticamente quaisquer pull requests, alterando o branch base para o branch base do pull request mesclado. Para saber mais, confira "Sobre ramificações".

As solicitações de pull são mescladas por meio da opção --no-ff, exceto as solicitações de pull que têm commits com mesclagem squash ou com troca de base, que são mescladas por meio da opção de avanço rápido.

Você pode vincular uma solicitação de pull a um problema para mostrar que uma correção está em andamento e para fechar automaticamente o problema quando alguém mesclar a solicitação de pull. Para obter mais informações, confira "Vinculando uma pull request a um problema".

Se você decidir que não deseja que as alterações em um branch do tópico sejam mescladas com o branch upstream, feche a solicitação de pull sem mesclá-la.

Mesclar uma solicitação de pull

  1. Abaixo do nome do repositório, clique em Solicitações de pull.

    Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como "Solicitações de pull", é destacada em laranja escuro.

  2. Na lista "Pull Requests", clique na pull request que deseja fazer merge.

  3. Role a página até o final da solicitação de pull. Dependendo das opções de merge habilitadas em seu repositório, é possível:

    Note

    A troca de base e a mesclagem sempre atualizarão as informações do autor do commit e criarão SHAs de commit. Para obter mais informações, confira "Sobre as mesclagens de solicitações de pull".

  4. Se solicitado, digite uma mensagem de commit ou aceite a mensagem padrão.

    Para obter informações sobre as mensagens de commit padrão para mesclagens squash, confira "Sobre merges de pull request".

  5. Se você tiver mais de um endereço de email associado à sua conta em GitHub, clique no menu suspenso do endereço de email e selecione o email a ser usado como o endereço de email do autor do Git. Apenas endereços de e-mail verificados aparecem neste menu suspenso. Se você habilitou a privacidade do endereço de email, um email sem resposta será o endereço de email do autor de commit padrão. Para obter mais informações sobre a forma exata que o endereço de email sem resposta pode assumir, consulte "Configurar o endereço de e-mail do commit”.

    Captura de tela de uma solicitação de pull do GitHub que mostra um menu suspenso com opções para escolher o endereço de email do autor do commit. octocat@github.com está selecionado.

    Note

    O seletor de email não está disponível para mesclagens de troca de base, que não criam um commit de mesclagem. Para as mesclagens squash, o seletor de email só será mostrado se você for o autor da solicitação de pull e tiver mais de um endereço de email associado à sua conta.

  6. Clique em Confirmar mesclagem, Confirmar mesclagem squash e mesclagem ou Confirmar troca de base e mesclagem.

  7. Opcionalmente, exclua o branch. Assim, a lista de branches do repositório ficará limpa.

Para saber mais sobre GitHub CLI, confira "Sobre o a CLI do GitHub".

Para mesclar uma solicitação de pull, use o subcomando gh pr merge. Substitua pull-request pelo número, pela URL ou pelo branch principal da solicitação de pull.

gh pr merge PULL-REQUEST

Siga as instruções interativas para realizar o merge. Para obter mais informações sobre os métodos de mesclagem que você pode escolher, confira "Sobre merges de pull request".

Como alternativa, você pode usar sinalizadores para ignorar as instruções interativas. Por exemplo, esse comando fará a combinação por squash dos commits em um único commit com a mensagem de "my squash commit", faça o merge do commit combinado por squash no branch de base e exclua o branch local e o remoto.

gh pr merge 523 --squash --body "my squash commit" --delete-branch

Leitura adicional