Skip to main content

Como criar uma solicitação de pull

Crie uma solicitação de pull para propor e colaborar em alterações em um repositório. Essas alterações são propostas em um branch, que garante que o branch-padrão só contenha trabalho concluído e aprovado.

Who can use this feature

Anyone with read access to a repository can create a pull request.

Caso deseje criar um novo branch para seu pull request e não tenha permissões de gravação no repositório, você pode bifurcar o repositório primeiro. Para obter mais informações, confira "Como criar uma solicitação de pull com base em um fork" e "Sobre os forks".

É possível especificar em qual branch você deseja fazer merge de suas alterações quando cria sua pull request. As pull requests só podem ser abertas entre dois branches que são diferentes.

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".

Alterar o intervalo de branches e o repositório de destino

Por padrão, as pull requests são baseadas no branch padrão do repositório principal. Para obter mais informações, confira "Sobre os branches".

Se o repositório principal padrão não estiver correto, você poderá alterar o repositório principal e o branch com as listas suspensas. Também é possível trocar o head e os branches base com as listas suspensas para estabelecer diffs entre pontos de referência. As referências aqui devem ser nomes de branch no seu repositório do GitHub.

Branches de edição da pull request

Ao pensar nos branches, lembre-se de que o branch base é o local em que as alterações devem ser aplicadas e o branch principal contém o que você deseja aplicar.

Quando você muda o repositório base, também muda as notificações para a pull request. Cada indivíduo que puder fazer push no repositório base receberá uma notificações de e-mail e verá a nova pull request no respectivo painel na próxima vez que se conectar.

Quando você muda qualquer uma das informações no intervalo de branches, as áreas de visualização de commit e arquivos alterados são atualizadas para mostrar o novo intervalo.

Dicas:

  • Usando a exibição de comparação, é possível configurar comparações entre períodos. Para obter mais informações, confira "Como comparar commits".
  • Os mantenedores de projeto podem adicionar um modelo de pull request para um repositório. Os modelos incluem solicitações de informações no texto de uma pull request. Para obter mais informações, confira "Sobre os modelos de solicitação de pull e de problema".

Criar a pull request

  1. No your GitHub Enterprise Server instance, navegue até a página principal do repositório.
  2. No menu "Branch", escolha o branch que contém seus commits. Menu suspenso do branch 1. Acima da lista de arquivos, clique em Solicitação de pull. Link "Solicitação de pull" acima da lista de arquivos
  3. Use o menu suspenso do branch base para selecionar o branch no qual deseja mesclar as alterações e use o menu suspenso do branch de comparação para escolher o branch do tópico no qual você fez as alterações. Menus suspensos usados para escolher os branches base e de comparação 1. Digite um título e uma descrição para a pull request. Campos de título e descrição da solicitação de pull 1. Para criar uma solicitação de pull pronta para revisão, clique em Criar Solicitação de Pull. Para criar uma solicitação de pull de rascunho, use o manu suspenso, selecione Criar Solicitação de Pull de Rascunho e clique em Solicitação de Pull de Rascunho. Para obter mais informações sobre as solicitações de pull de rascunho, confira "Sobre as solicitações de pull". Botão Criar solicitação de pull

Dica: depois de criar uma solicitação de pull, solicite a uma pessoa específica que revise suas alterações propostas. Para obter mais informações, confira "Como solicitar uma revisão de solicitação de pull".

Depois que a sua solicitação de pull for revisada, ela poderá ser mesclada no repositório.

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

Para criar uma solicitação de pull, use o subcomando gh pr create.

gh pr create

Para atribuir uma solicitação de pull a uma pessoa, use o sinalizador --assignee ou -a. Você pode usar @me para atribuir a solicitação de pull automaticamente.

gh pr create --assignee "@octocat"

Para especificar o branch no qual deseja mesclar a solicitação de pull, use o sinalizador --base ou -B. Para especificar o branch que contém os commits da sua solicitação de pull, use o sinalizador --head ou -H.

gh pr create --base my-base-branch --head my-changed-branch

Para incluir um título e um corpo na nova solicitação de pull, use o sinalizador --title ou --body.

gh pr create --title "The bug is fixed" --body "Everything works again"

Para marcar uma solicitação de pull como um rascunho, use o sinalizador --draft.

gh pr create --draft

Para adicionar rótulos ou marcos à nova solicitação de pull, use o sinalizador --label ou --milestone.

gh pr create --label "bug,help wanted" --milestone octocat-milestone

Para adicionar a nova solicitação de pull a um projeto específico, use o sinalizador --project.

gh pr create --project octocat-project

Para atribuir uma pessoa ou uma equipe como revisor, use o sinalizador --reviewer.

gh pr create --reviewer monalisa,hubot  --reviewer myorg/team-name

Para criar a solicitação de pull no navegador da Web padrão, use o sinalizador --web.

gh pr create --web
  1. Alterne para o branch para o qual você deseja criar um pull request. Para obter mais informações, confira "Como alternar entre branches".
  2. Clique em Criar Solicitação de Pull. GitHub Desktop abrirá o seu navegador-padrão para levar você a GitHub. O botão Criar Solicitação de Pull
  3. No GitHub, confirme se o branch no menu suspenso base: é o branch em que deseja mesclar as alterações. Confirme se o branch no menu suspenso comparação: é o branch do tópico em que você fez as alterações. Menus suspensos usados para escolher os branches base e de comparação 1. Digite um título e uma descrição para a pull request. Campos de título e descrição da solicitação de pull 1. Para criar uma solicitação de pull pronta para revisão, clique em Criar Solicitação de Pull. Para criar uma solicitação de pull de rascunho, use o manu suspenso, selecione Criar Solicitação de Pull de Rascunho e clique em Solicitação de Pull de Rascunho. Para obter mais informações sobre as solicitações de pull de rascunho, confira "Sobre as solicitações de pull". Botão Criar solicitação de pull
  1. Alterne para o branch para o qual você deseja criar um pull request. Para obter mais informações, confira "Como alternar entre branches".
  2. Clique em Criar Solicitação de Pull. GitHub Desktop abrirá o seu navegador-padrão para levar você a GitHub. O botão Criar Solicitação de Pull
  3. No GitHub, confirme se o branch no menu suspenso base: é o branch em que deseja mesclar as alterações. Confirme se o branch no menu suspenso comparação: é o branch do tópico em que você fez as alterações. Menus suspensos usados para escolher os branches base e de comparação 1. Digite um título e uma descrição para a pull request. Campos de título e descrição da solicitação de pull 1. Para criar uma solicitação de pull pronta para revisão, clique em Criar Solicitação de Pull. Para criar uma solicitação de pull de rascunho, use o manu suspenso, selecione Criar Solicitação de Pull de Rascunho e clique em Solicitação de Pull de Rascunho. Para obter mais informações sobre as solicitações de pull de rascunho, confira "Sobre as solicitações de pull". Botão Criar solicitação de pull

Leitura adicional