Criar solicitações de pull

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server | 2019 TFS 2018

Visual Studio 2022 | | Visual Studio 2019 Visual Studio 2017 | Visual Studio 2015

Crie PRs (solicitações de pull) para alterar, revisar e mesclar código em um repositório Git. Você pode criar PRs a partir de branches no repositório upstream ou de branches em sua bifurcação do repositório. Sua equipe pode examinar as PRs e fazer comentários sobre as alterações. Os revisores podem percorrer as alterações propostas, deixar comentários e votar para aprovar ou rejeitar as PRs. Dependendo das políticas de branch e de outros requisitos, sua PR pode precisar atender a vários critérios antes de concluir a PR e mesclar as alterações no branch de destino.

Para obter diretrizes de PR e considerações de gerenciamento, consulte Sobre solicitações de pull.

Pré-requisitos

  • Repos deve estar habilitado em seu projeto. Se o hub de Repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço de Azure DevOps para reencável Repos.

  • Para exibir ou examinar PRs, você deve ser membro de um projeto de Azure DevOps com acesso básico ou superior.

  • Para contribuir com uma PR, você deve ser membro do grupo de segurança Leitores ou ter as permissões correspondentes.

  • Para criar e concluir uma PR, você deve ser membro do grupo de segurança Colaboradores ou ter as permissões correspondentes.

    Observação

    Para projetos públicos, os usuários que receberam acesso ao Stakeholder têm acesso total a Azure Repos.

  • Repos deve estar habilitado em seu projeto. Se o hub de Repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço de Azure DevOps para reencável Repos.
  • Para exibir ou examinar PRs, você deve ser membro do projeto Azure DevOps com acesso básico ou superior. Se você não for membro do projeto, será adicionado.
  • Para criar e concluir uma PR, você deve ser membro do grupo de segurança Colaboradores ou ter as permissões correspondentes no projeto que deseja alterar.
  • Para contribuir com uma PR, você deve ser membro do grupo de segurança Leitores ou ter as permissões correspondentes.
  • Para criar e concluir uma PR, você deve ser membro do grupo de segurança Colaboradores ou ter as permissões correspondentes.
  • Para exibir ou examinar PRs, você deve ser membro de um projeto de Azure DevOps com acesso básico ou superior. Se você não for membro do projeto, será adicionado.
  • Para contribuir com uma PR, você deve ser membro do grupo de segurança Leitores ou ter as permissões correspondentes.

Crie uma solicitação de pull

Você pode criar uma nova PR no site do projeto Azure DevOps, de Visual Studio ou da CLI Azure DevOps.

No site do projeto Azure DevOps, você pode criar uma nova PR de:

Criar uma PR na página De solicitações pull

Você pode criar PRs para qualquer branch na página de solicitações pull do projeto na Web.

  1. Na página de solicitações Repos >Pull, selecione Nova solicitação de pull no canto superior direito.

    Screenshot of the New pull request button.

  2. Selecione o branch com as alterações e o branch no qual você deseja mesclar as alterações, como o branch principal.

    Screenshot of source and target branches for a P R in Azure Repos.

  3. Insira seus detalhes de PR e crie a PR.

Criar uma PR com base em um branch enviado por push

Depois de enviar por push ou atualizar um branch de recursos, Azure Repos exibirá um prompt para criar uma PR.

  • Na página De solicitações pull :

    Screenshot that shows the prompt to create a P R on the Pull Requests tab in Azure Repos.

  • Na página Arquivos :

    Screenshot that shows the prompt to create a P R on the Files tab in Azure Repos.

Selecione Criar uma solicitação de pull para ir para uma página em que você pode inserir seus detalhes de PR e criar a PR.

Depois de enviar por push ou atualizar um branch de recursos, Azure Repos solicitará que você crie uma PR no modo de exibição Código na Web. Esse prompt é exibido em Solicitações e Arquivos de Pull.

Screenshot that shows the prompt to create a P R on the Pull Requests tab in Azure Repos.

Screenshot that shows the prompt to create a P R on the Files tab in Azure Repos.

Selecione Criar uma solicitação de pull para ir para uma página em que você pode inserir seus detalhes de PR e criar a PR.

Criar uma PR com base em um item de trabalho vinculado

Você pode criar uma PR diretamente de um item de trabalho Azure Boards vinculado ao branch.

  1. No Azure Boards, em Backlogs ou Consultas na exibição Trabalho, abra um item de trabalho vinculado ao branch.

  2. Na área Desenvolvimento do item de trabalho, selecione Criar uma solicitação de pull.

    Screenshot of creating a PR from the Development area of a work item with a linked branch.

O link leva você para uma página em que você pode inserir seus detalhes de PR e criar a PR.

Adicionar atualizações com cherry-pick

Você pode copiar confirmações de um branch para outro usando cherry-pick. Ao contrário de uma mesclagem ou rebase, a escolha de cereja só traz as alterações das confirmações selecionadas, em vez de todas as alterações em um branch.

Para escolher as alterações de uma PR concluída, selecione Cherry-pick na página Visão geral da PR. Para copiar as alterações de uma PR ativa, selecione Cherry-pick no menu Mais opções da PR. Essa ação cria um novo branch com as alterações copiadas. Em seguida, você pode criar uma nova PR a partir do novo branch. Para obter instruções detalhadas, consulte Copiar alterações com cherry-pick.

Alternar ramificações de origem e destino de sua solicitação de pull

Antes da primeira vez que você salvar uma PR, você pode alternar os branches de origem e destino da PR selecionando o ícone de origem e branches de destino do Switch ao lado dos nomes de branch. Depois que a PR estiver ativa, esse ícone desaparecerá, mas você ainda poderá alterar o branch de destino da PR.

Screenshot of the switch source and target branches icon.

Usar modelos de solicitação de pull

Um modelo de solicitação de pull é um arquivo que contém o texto Markdown que preenche a descrição de PR quando você cria uma PR. Boas descrições de RP dizem aos revisores de RP o que esperar e podem ajudar a controlar tarefas como adicionar testes de unidade e atualizar a documentação. Sua equipe pode criar um modelo de PR padrão que adiciona texto a todas as novas descrições de PR no repositório. Além disso, você pode selecionar entre modelos específicos de ramificação ou outros modelos que sua equipe define. Para obter mais informações sobre como criar e usar modelos de PR, consulte Aprimorar descrições de solicitação de pull usando modelos.

Se o repositório tiver um modelo padrão, todos os PRs no repositório terão o texto de descrição do modelo padrão na criação. Para adicionar outros modelos, selecione Adicionar um modelo e escolha um modelo na lista suspensa. Você pode editar o texto do modelo em sua descrição, removê-lo ou adicionar outro texto.

Screenshot showing Add a template when creating a P R.

Criar PRs de rascunho

Se sua PR não estiver pronta para revisão, você poderá criar um rascunho de PR para indicar o trabalho em andamento. Quando a PR estiver pronta para revisão, você poderá publicá-la e começar ou retomar o processo de revisão completa.

PRs de rascunho têm as seguintes diferenças em relação às PRs publicadas:

  • As políticas de validação de build não são executadas automaticamente. Você pode enfileirar validações de build manualmente selecionando o menu de mais opções na PR.

  • A votação está desabilitada enquanto estiver no modo de rascunho.

  • Os revisores necessários não são adicionados automaticamente. As notificações são enviadas somente aos revisores que você adiciona explicitamente ao rascunho de PR.

  • PRs de rascunho são exibidos na lista de PR com um selo rascunho .

    Screenshot showing a draft P R in the P R list.

Observação

A criação de PRs de rascunho requer Azure DevOps Server atualização 2019.1 ou versão posterior.

Para criar um rascunho de PR, selecione a seta ao lado de Criar e selecione Criar como rascunho ao criar a PR. Você não precisa usar prefixos de título, como WIP ou DO NOT MERGE.

Screenshot showing Create as draft P R.

Quando você estiver pronto para ter a PR revisada e concluída, selecione Publicar no canto superior direito na PR. A publicação de uma PR atribui revisores necessários, avalia as políticas e inicia a votação.

Screenshot showing Publish for a P R.

Para alterar uma PR publicada existente para um rascunho, escolha Marcar como rascunho. Marcar uma PR como rascunho remove todos os votos existentes.

Screenshot showing Mark as draft.

Observação

Esse recurso requer Azure DevOps Server atualização 2019.1 ou versão posterior.

Adicionar ou editar o título e a descrição da solicitação de pull

Na página Nova solicitação de pull , insira um Título e uma descrição detalhada de suas alterações, para que outras pessoas possam ver quais problemas as alterações resolvem. Em uma nova PR como em PRs existentes, você pode ver os Arquivos e Confirmações em sua PR em guias separadas. Você pode adicionar revisores, vincular itens de trabalho e adicionar marcas à PR.

Quando você estiver pronto para examinar suas alterações, selecione Criar para criar a PR.

Screenshot that shows creating a new P R.

Adding details to a new P R.

Não se preocupe se você não tiver todos os itens de trabalho, revisores ou detalhes prontos ao criar sua PR. Você pode adicionar ou atualizar esses itens depois de criar a PR.

Editar título e descrição de PR

Mantenha o título de PR e a descrição atualizados para que os revisores possam entender as alterações na PR.

Você pode atualizar o título de uma PR existente selecionando o título atual e atualizando o texto. Selecione o ícone Salvar para salvar alterações ou selecione o ícone Desfazer para descartar as alterações.

Edite a descrição de PR selecionando o ícone Editar na seção Descrição .

Screenshot that shows editing the P R title and selecting the description Edit button.

Adicionar revisores a uma solicitação pull

Você pode adicionar revisores na seção Revisores de uma PR nova ou existente. Você também pode tornar necessários revisores opcionais existentes ou alterar os revisores necessários para opcional ou removê-los, a menos que eles sejam exigidos pela política.

As políticas de branch podem exigir um número mínimo de revisores ou incluir automaticamente determinados revisores opcionais ou necessários em PRs. Não é possível remover revisores exigidos pela política de branch. Você pode alterar revisores opcionais da política de branch a serem necessários ou removê-los.

Para ver a política de branch que adicionou automaticamente um revisor, na seção Revisores da página Visão Geral de PR, clique com o botão direito do mouse em Mais opções ao lado do revisor.

Screenshot that shows View policy on a reviewer that's automatically included by branch policy.

Se o usuário ou grupo que você deseja examinar sua PR não for um membro do seu projeto, você precisará adicioná-lo ao projeto antes de adicioná-lo como revisores.

Para adicionar revisores a uma nova PR:

  1. Na página Nova solicitação pull , em Revisores, selecione Pesquisar usuários e grupos a serem adicionados como revisores.
  2. Ao inserir um nome ou endereço de email, uma lista suspensa mostra uma lista de usuários e grupos correspondentes. Selecione nomes da lista a serem adicionados como revisores opcionais.
  3. Para adicionar revisores necessários, selecione Adicionar revisores necessários e selecione Pesquisar para adicionar revisores necessários para pesquisar e selecionar os nomes.

Screenshot of adding a reviewer to a new P R.

Para adicionar revisores a uma PR existente:

  1. Na seção Revisores da página Visão Geral , selecione Adicionar e selecione Revisor Obrigatório ou Revisor Opcional.

    Pull request overview

  2. À medida que você insere um nome ou endereço de email, uma lista de usuários ou grupos correspondentes é exibida. Selecione os nomes a serem adicionados como revisores.

    Add P R reviewer.

Para alterar um revisor entre obrigatório e opcional ou remover um revisor, selecione Mais opções à direita do nome do revisor. Para ver a associação de um grupo ou equipe designada como revisor, selecione o ícone do grupo.

Para adicionar revisores à sua PR:

  1. Selecione a guia Visão geral na PR.

    PR overview

  2. Selecione o botão adicionar na área Revisores .

  3. Insira o nome do usuário ou grupo a ser adicionado à lista de revisor para a PR. Se o usuário não for um membro do seu projeto, você precisará adicioná-lo.

  4. À medida que você insere um nome ou endereço de email, uma lista de usuários ou grupos correspondentes é exibida. Selecione o usuário ou grupo na lista para adicioná-lo como revisor.

    Add PR reviewer

Para vincular itens de trabalho a uma nova PR:

  1. Na página Nova solicitação de pull , em itens de trabalho para vincular, selecione Pesquisar itens de trabalho por ID ou título.
  2. Comece a inserir uma ID ou título de item de trabalho e selecione o item de trabalho a ser vinculado na lista suspensa exibida.

Para vincular itens de trabalho a uma PR existente:

  1. Na guia Visão Geral de PR, na área Itens de Trabalho , selecione +.

    Screenshot that shows selecting the Overview tab and the work items section.

  2. Insira a ID do item de trabalho ou pesquise o título do item de trabalho. Selecione o item de trabalho na lista exibida.

Remova um link de item de trabalho selecionando o ícone x ao lado do item de trabalho. Remover um link remove apenas o link entre o item de trabalho e a PR. Os links criados no branch ou de confirmações permanecem no item de trabalho.

Para vincular itens de trabalho à PR:

  1. Selecione a guia Visão geral na PR.

    Screenshot that shows selecting the Overview tab and the link items button.

  2. Selecione o botão adicionar na área Itens de Trabalho . Add icon in PRs

  3. Insira a ID do item de trabalho ou pesquise itens de trabalho com títulos que correspondam ao texto. Selecione o item de trabalho na lista exibida.

Remova links de item de trabalho selecionando o botão remover que aparece quando você passa o mouse sobre o item de trabalho. remove button Remover um link remove apenas o vínculo entre um item de trabalho para uma PR. Os links criados no branch ou de confirmações permanecem no item de trabalho.

Para vincular itens de trabalho à PR:

  1. Selecione Visão geral na PR.

    Select Overview in the PR.

  2. Selecione o botão adicionar na área Itens de Trabalho .

  3. Insira a ID do item de trabalho ou pesquise itens de trabalho com títulos que correspondam ao texto. Selecione o item de trabalho na lista exibida.

Remova links de item de trabalho selecionando o botão remover que aparece quando você passa o mouse sobre o item de trabalho. remove icon Remover um link remove apenas o link entre o item de trabalho e a PR. Os links criados no branch ou de confirmações permanecem no item de trabalho.

Adicionar marcas a uma solicitação de pull

Use marcas para mostrar detalhes importantes e ajudar a organizar PRs. As marcas podem comunicar informações extras aos revisores, por exemplo, que a PR ainda é um trabalho em andamento ou é um hotfix para uma versão futura.

Screenshot showing P Rs with tags.

Para adicionar uma marca ao criar uma PR, digite um nome de marca na seção Marcas . Depois de criar a PR, você pode gerenciar marcas na seção Marcas .

Screenshot that shows the P R Tags section highlighted.

Adicionar rótulos a uma solicitação de pull

Você pode comunicar informações extras sobre uma PR aos revisores usando rótulos. Talvez a PR ainda seja um trabalho em andamento ou seja um hotfix para uma versão futura. Use rótulos para comunicar detalhes importantes e ajudar a organizar PRs.

Observação

O uso de rótulos de PR requer o TFS 2018.2 ou versão posterior.

Screenshot showing P Rs with labels.

Para adicionar um rótulo ao criar uma PR, escolha Adicionar rótulo. Depois de criar uma PR, você pode gerenciar seus rótulos na seção Rótulos .

Add P R label

Adicionar anexos a solicitações de pull

Você pode anexar arquivos, incluindo imagens, à sua PR durante ou após a criação. Selecione o ícone de clipe de papel abaixo do campo Descrição ou arraste e solte arquivos diretamente no campo Descrição da PR.

Screenshot that shows attaching files to the P R description during creation.

Alterar o branch de destino de uma solicitação de pull ativa

Para a maioria das equipes, quase todos os PRs têm como destino um branch padrão, como main ou develop. Se às vezes você precisar direcionar um branch diferente, é fácil esquecer de alterar o branch de destino ao criar a PR. Se isso acontecer, você poderá alterar o branch de destino de uma PR ativa:

  1. Selecione Mais ações no canto superior direito na página Visão Geral de PR e selecione Alterar branch de destino no menu suspenso.
  2. No painel Alterar branch de destino , selecione Escolher um branch de destino, selecione o novo branch e selecione Alterar.

Notificações de solicitação de pull de email para stakeholders

Você pode compartilhar uma solicitação pull por email para notificar os revisores e se comunicar com os membros da equipe. Para compartilhar uma PR:

  1. Selecione Mais opções na página Visão Geral de PR e selecione Compartilhar solicitação de pull.

    Screenshot that shows selecting Share pull request on a P R's Overview page.

  2. Na tela de solicitação de pull de compartilhamento, adicione destinatários digitando seus nomes no campo Para: e selecionando entre os nomes de usuário que aparecem. Você também pode remover destinatários.

  3. Adicione uma mensagem opcional no campo Observação (Opcional) e selecione Enviar. Os destinatários recebem um email solicitando sua atenção e vinculando-se à PR.

Observação

Se você usar o recurso de email interno, só poderá enviar o email para os endereços individuais dos membros do projeto. Não há suporte para a adição de um grupo de equipe ou grupo de segurança à linha To: . Se você adicionar uma conta de email que o sistema não reconhece, você receberá uma mensagem informando que um ou mais destinatários do email não têm permissões para ler a solicitação de pull enviada por email.

Para que o recurso de email funcione, o administrador do Azure DevOps Server deve configurar um servidor SMTP.

Próximas etapas