Mantendo o seu pull request em sincronia com o branch de base

Após abrir um pull request, você poderá atualizar o branch principal, que contém suas alterações, com todas as alterações que foram feitas no branch de base.

Quem pode usar esse recurso?

People with write permissions to the repository to which the head branch of the pull request belongs can update the head branch with changes that have been made in the base branch.

Neste artigo

Sobre como manter o seu pull request sincronizado

Antes de mesclar suas solicitações de pull, outras alterações podem ser mescladas no branch base, fazendo com que o branch principal da solicitação de pull fique fora de sincronia. A atualização da solicitação de pull com as alterações mais recentes do branch base pode ajudar a detectar problemas antes da mesclagem.

Você pode atualizar o branch de principal de um pull request na linha de comando ou na página do pull request. O botão Atualizar branch é exibido quando todas as seguintes afirmações são verdadeiras:

  • Não há conflitos de merge entre o branch do pull request e o branch de base.
  • O branch do pull request não está atualizado com o branch de base.
  • O branch base requer que os branches estejam atualizados antes da mesclagem ou que a configuração para sempre sugerir a atualização dos branches esteja habilitada.

Para saber mais, confira Sobre branches protegidos e Gerenciando sugestões para atualizar os branches do pull request.

Se houver alterações no branch de base que causam conflitos de merge no branch do seu pull request, você não poderá atualizar o branch até que todos os conflitos sejam resolvidos. Para saber mais, confira Sobre conflitos de mesclagem.

Na página da solicitação de pull, é possível atualizar o branch da solicitação de pull usando uma mesclagem tradicional ou uma troca de base. Um merge tradicional resulta em um commit de merge que faz o merge do branch de base no branch principal do pull request. A troca de base aplica as alterações do seu branch à última versão do branch base. O resultado é um branch com histórico linear, uma vez que nenhum commit de merge foi criado.

Atualizando o branch do seu pull request

  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 no pull request que você deseja atualizar.

  3. Na seção de merge perto do final da página, você pode:

    • Clique em Atualizar branch para fazer uma mesclagem tradicional.

      Captura de tela da seção de mesclagem de uma solicitação de pull.

    • Clique no menu suspenso Atualizar branch, clique em Atualizar com a troca de base e clique em Trocar a base do branch para fazer a atualização pela troca de base no branch base.

      Captura de tela da seção de mesclagem de uma solicitação de pull. O menu suspenso é expandido, que mostra as opções "Atualizar com commit de mesclagem" e "Atualizar com troca de base".

Leitura adicional