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.

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. Para obter mais informações, confira "Sobre os branches protegidos".

Você pode configurar um pull request para fazer merge automaticamente quando todos os requisitos de merge forem atendidos. Para obter mais informações, confira "Mesclar uma solicitação de pull automaticamente".

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 as solicitações de pull de rascunho, confira "Sobre as solicitações 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 "Como gerenciar a exclusão automática de branches".

Observação: 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 obter mais informações, confira "Sobre os branches".

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 "Como vincular uma solicitação de pull 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. Seleção da guia Problemas e solicitações de pull

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

  3. Dependendo das opções de merge habilitadas em seu repositório, é possível:

    Observação: 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 mesclagens de solicitação de pull". Campo de mensagem de commit

  5. Se você tiver mais de um endereço de email associado à sua conta do GitHub.com, clique no menu suspenso do endereço de email e selecione o endereço de 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, <username>@users.noreply.github.com é o endereço de email do autor de commit padrão. Para obter mais informações, confira "Como definir seu endereço de email de commit". Escolher endereços de email de commit

    Observação: 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 a GitHub CLI, confira "Sobre a GitHub CLI".

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 as mesclagens de solicitações de pull".

Como alternativa, você pode usar sinalizadores para ignorar as instruções interativas. Por exemplo, esse comando irá fazer 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