Criar solicitações pull

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Visual Studio 2019 | Visual Studio 2022

Crie solicitações pull (PRs) para alterar, revisar e mesclar código em um repositório Git. Você pode criar RPs a partir de ramificações no repositório upstream ou de ramificações em sua bifurcação do repositório. A sua equipa pode rever os PRs e dar feedback sobre as alterações. Os revisores podem analisar as alterações propostas, deixar comentários e votar para aprovar ou rejeitar as RPs. Dependendo das políticas da filial e de outros requisitos, sua RP pode precisar atender a vários critérios antes de concluir a RP e mesclar as alterações na ramificação de destino.

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

Pré-requisitos

Categoria	Requerimentos
Níveis de acesso	- Ver ou rever PRs: Pelo menos Acesso básico. Para projetos públicos, os usuários Acesso de partes interessadas têm acesso total aos repositórios do Azure.
Permissões	- Participe em um PR: Membro do grupo de segurança Leitores ou permissões correspondentes. - Criar e completar um PR: Membro do grupo de segurança Colaboradores ou permissões correspondentes.
Serviços	Repos ativado.
Ferramentas	CLI do Azure DevOps.

Para obter mais informações sobre permissões e acesso, consulte Permissões padrão de repositório Git e ramificações e Sobre níveis de acesso.

Criar uma solicitação de pull

Você pode criar uma nova RP a partir do site do projeto Azure DevOps, do Visual Studio ou da CLI do Azure DevOps.

Browser

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

• A página de Pedidos de Pull.
• Uma ramificação de recurso empurrada para o seu repositório.
• Um PR existente, usando cherry-pick.
• O controle de Desenvolvimento em um item de trabalho vinculado do Azure Boards.

Criar um PR a partir da página de Solicitações de Pull

Você pode criar PRs para qualquer ramificação a partir da página Pull Requests do seu projeto na web.

1. Na página Repos>Pedidos pull, selecione Novo pedido pull no canto superior direito.

   

2. Selecione a ramificação com as alterações e a ramificação na qual você deseja mesclar as alterações, como a ramificação principal.

   

3. Introduza os seus dados de RP e crie o PR.

Criar uma RP a partir de uma ramificação empurrada

Depois de fazer push ou atualizar uma ramificação de recurso, o Azure Repos exibe um prompt para criar um PR.

• Na página Pull requests:

  

• Na página Ficheiros :

  

Selecione Criar um pull request para ir para uma página onde você pode inserir seus detalhes de RP e criar o PR.

Criar uma RP a partir de um item de trabalho vinculado

Você pode criar uma RP diretamente de um item de trabalho do Azure Boards vinculado à ramificação.

1. No Azure Boards, em Listas de pendências ou Consultas na vista Trabalho, abra um item de trabalho ligado à ramificação.

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

   

O link leva-o a uma página onde pode introduzir os seus dados de RP e criar o PR.

Estúdio Visual

Para criar uma solicitação pull:

1. No menu Git , selecione Gerenciar ramificações.

2. Clique com o botão direito do mouse em uma ramificação e selecione Criar solicitação pull.

3. Edite as ramificações de origem e de destino conforme necessário, insira um título e uma descrição opcional e selecione Criar.

O Visual Studio 2019 versão 16.8 e versões posteriores fornece uma experiência de controle de versão do Git enquanto mantém a interface de usuário do Team Explorer Git. Para usar Team Explorer, desmarque Ferramentas>Opções>Recursos de Pré-Visualização>Nova experiência de utilizador do Git da barra de menus. Você pode exercitar os recursos do Git a partir de qualquer interface de forma intercambiável.

Para criar PRs no Visual Studio Team Explorer:

1. Conecte-se ao seu projeto a partir do Visual Studio.

2. Selecione Exibir>Team Explorer para abrir o Team Explorer. Você também pode pressionar Ctrl+\Ctrl+M.

3. Em Página inicial, selecione Pull Requests para visualizar listas de RPs abertas por você ou atribuídas a você.

4. Na visualização Pull Requests , selecione New Pull Request.

   

5. Selecione as ramificações de origem e destino, insira um título e uma descrição opcional e selecione Criar.

   

6. Depois que a RP for criada, selecione Abrir no navegador para abrir a nova RP no portal da Web do Azure DevOps.

Você também pode criar PRs a partir da vista Ramificações no Team Explorer, clicando com o botão direito no nome da ramificação e selecionando Criar Pull Request.

Para criar um novo PR em seu projeto, use az repos pr create. Para abrir o PR no seu navegador após a criação, use o --open parâmetro.

az repos pr create [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--open]
                   [--org]
                   [--project]
                   [--repository]
                   [--reviewers]
                   [--source-branch]
                   [--squash {false, true}]
                   [--subscription]
                   [--target-branch]
                   [--title]
                   [--transition-work-items {false, true}]
                   [--work-items]

Parâmetros

Parâmetro	Descrição
--auto-complete	Defina a solicitação pull para ser concluída automaticamente e mesclar na ramificação de destino quando todas as políticas forem aprovadas. Valores aceites: false, true.
--bypass-policy	Ignore todas as políticas necessárias e conclua a solicitação pull assim que ela puder ser mesclada. Valores aceites: false, true.
--bypass-policy-reason	Razão para ignorar as políticas necessárias.
--delete-source-branch	Exclua a ramificação de origem depois que o pedido de pull for concluído e mesclado na ramificação de destino. Valores aceites: false, true.
--description -d	Descrição da nova solicitação pull, que pode incluir Markdown. Cada valor é uma nova linha. Por exemplo: --description "First Line" "Second Line".
--detect	Detete automaticamente a organização. Valores aceites: false, true.
--draft	Crie a solicitação pull no modo de rascunho como trabalho em andamento. Valores aceites: false, true.
--merge-commit-message	Mensagem que aparece quando se fundem commits.
--open	Abra a solicitação pull no seu navegador da Web.
--org --organization	URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
--project -p	Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Necessário se não configurado como padrão ou captado via git config.
--repository -r	Nome ou ID do repositório para criar a solicitação pull. Parâmetro necessário.
--reviewers	Outros usuários ou grupos a incluir como revisores no novo pull request. Espaço separado.
--source-branch -s	Nome da ramificação de origem. Exemplo: "dev".
--squash	Comprima os commits na ramificação de origem ao integrar na ramificação de destino. Valores aceites: false, true.
--subscription	Nome ou ID da assinatura do Azure. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
--target-branch -t	Nome da ramificação de destino. Se não for especificado, usa-se a ramificação padrão do repositório de destino.
--title	Título do novo pull request.
--transition-work-items	Transfira todos os itens de trabalho vinculados à RP para o próximo estado lógico quando a RP mudar de status. Por exemplo, altere Itens de trabalho ativos para Resolvido. Valores aceites: false, true.
--work-items	IDs de itens de trabalho para vincular à nova solicitação pull. Espaço separado.

Exemplo

O comando a seguir cria um PR da ramificação para a new ramificação padrão main do repositório da Fabrikam, abre o PR no navegador e mostra a saída do comando em uma tabela. O exemplo usa a configuração padrão: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos pr create --repository Fabrikam --source-branch new --open --output table

ID    Created     Creator              Title                         Status    IsDraft    Repository
----  ----------  -------------------  ----------------------------  --------  ---------  ------------
30    2021-10-31  jamalh@fabrikam.com  Updated note-new-git-tool.md  Active    False      Fabrikam

Você pode adicionar muitos outros detalhes de RP em ou após a criação de RP. Para adicionar detalhes, revisores, itens de trabalho e opções de conclusão à RP, consulte Adicionar detalhes ou editar RPs.

Adicionar atualizações com cherry-pick

Você pode copiar commits de uma ramificação para outra usando cherry-pick. Ao contrário de uma fusão ou rebase, o cherry-pick traz apenas as alterações dos commits selecionados, em vez de todas as alterações em um branch.

Para selecionar as alterações de um PR concluído, selecione Cherry-pick na página Visão geral do PR. Para copiar as alterações de um PR ativo, selecione Cherry-pick no menu Mais opções do PR. Esta ação cria uma nova ramificação com as alterações copiadas. Em seguida, podes criar um novo PR a partir do novo ramo. Para obter instruções detalhadas, consulte Copiar alterações com escolha seletiva.

Alternar ramificações de origem e destino do seu pull request

Antes da primeira vez que você salva uma RP, você pode alternar as ramificações de origem e de destino da RP selecionando o ícone Alternar ramificações de origem e destino ao lado dos nomes das filiais. Uma vez que o PR está ativo, esse ícone desaparece, mas você ainda pode alterar o ramo de destino do PR.

Usar modelos de solicitação pull

Um modelo de pull request é um ficheiro que contém texto em Markdown que preenche a descrição do PR quando cria um 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 RP padrão que adiciona texto a todas as novas descrições de RP no repositório. Além disso, você pode selecionar entre modelos específicos de ramificação ou outros modelos definidos por sua equipe. Para obter mais informações sobre como criar e usar modelos de RP, consulte Melhorar descrições de solicitação pull usando modelos.

Se o repositório tiver um modelo padrão, todos os RPs 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, em seguida, escolha um modelo na lista suspensa. Você pode editar o texto do modelo em sua descrição, removê-lo ou adicionar outro texto.

Criar rascunhos de RPs

Se o seu RP não estiver pronto para revisão, você pode criar um rascunho de RP para indicar o trabalho em andamento. Quando o PR estiver pronto para revisão, você poderá publicá-lo e iniciar ou retomar o processo de revisão completo.

Os projetos de RP apresentam as seguintes diferenças em relação aos RP publicados:

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

• A votação é desativada durante o modo de rascunho.

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

• Os PRs de rascunho são exibidos na lista de PR com um rótulo Rascunho.

  

Browser

Para criar uma RP de rascunho, selecione a seta ao lado de Criar e selecione Criar como rascunho ao criar a RP. Não é necessário usar prefixos de título como WIP ou DO NOT MERGE.

Quando estiver pronto para ter a RP revisada e concluída, selecione Publicar no canto superior direito da RP. A publicação de um RP atribui os revisores necessários, avalia as políticas e dá início à votação.

Para alterar uma RP publicada existente para um rascunho, escolha Marcar como rascunho. A marcação de um PR como projeto elimina todos os votos existentes.

Estúdio Visual

Para colocar uma RP em modo de rascunho, abra a RP e clique em Marcar como rascunho.

• Para abrir uma solicitação pull do Visual Studio, no menu Git, selecione <seu serviço>> GitView Pull Requests e selecione uma pull request para abri-la.
• Para abrir uma solicitação pull do Visual Studio Team Explorer, na visualização Pull Requests , clique com o botão direito do mouse na PR e selecione Abrir no navegador.

Para criares uma RP como rascunho, define o parâmetro --draft para true quando criares a RP. (Requer o Azure DevOps Server 2020 ou versão posterior.)

Por exemplo:

az repos pr create --repository Fabrikam --source-branch new --draft true

Para definir uma RP existente para rascunho, use az repos pr update --id <PR Id> --draft true.

Para remover o estado de rascunho de uma RP, defina --draft para false.

Adicionar ou editar o título e a descrição do pull request

Browser

Na página Novo pull request , 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 um novo PR como em PRs existentes, você pode ver os Arquivos e Confirmações em seu PR em guias separadas. Você pode adicionar revisores, vincular itens de trabalho e adicionar tags à RP.

Quando estiver pronto para rever as alterações, selecione Criar para criar a RP.

Não te preocupes se não tiveres todos os itens de trabalho, revisores ou detalhes prontos quando criares o teu PR. Você pode adicionar ou atualizar esses itens depois de criar o PR.

Editar título e descrição de RP

Mantenha o título e a descrição de RP atualizados para que os revisores possam entender as mudanças no RP.

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

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

Estúdio Visual

Quando você cria uma RP no Visual Studio, 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. Mantenha esses campos atualizados para que os revisores possam entender as mudanças no RP.

Para editar o título, a descrição ou quaisquer outros detalhes de uma RP existente, abra a RP no seu navegador.

Você pode adicionar detalhes durante a criação de PR com az repos pr create, ou atualizar detalhes em PRs existentes com az repos pr update.

Quando se cria um PR com az repos pr create, adicione um --title e uma descrição detalhada das alterações para que outras pessoas possam ver quais problemas as alterações resolvem. O --description parâmetro aceita a entrada Markdown e cada valor no argumento é uma nova linha da descrição PR.

Por exemplo:

az repos pr create --repository Fabrikam --source-branch new --title "Update the readme" --description "This PR updates the readme." "These are *new* changes."

Mantenha esses campos atualizados para que os revisores possam entender as mudanças no RP. Para atualizar os detalhes de um PR, use az repos pr update com o parâmetro PR --id necessário.

Por exemplo, para atualizar o título e a descrição do PR #21, use:

az repos pr update --id 21 --description "These updates are *no longer new*." --title "Old updates"

Adicionar revisores a uma solicitação pull

Browser

Você pode adicionar revisores na seção Revisores de uma RP nova ou existente. Você também pode alterar revisores opcionais para obrigatórios, alterar revisores obrigatórios para opcionais ou removê-los, a menos que sejam exigidos pela política.

As políticas de filiais podem exigir um número mínimo de revisores ou incluir automaticamente determinados revisores opcionais ou obrigatórios em RPs. Você não pode remover revisores exigidos pela política de filial, mas pode alterar revisores opcionais para obrigatórios ou removê-los.

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

Se o usuário ou grupo que você deseja revisar sua RP não for um membro do seu projeto, adicione-os ao projeto antes de adicioná-los como revisores.

Para adicionar revisores a uma nova RP, execute as seguintes etapas:

1. Na página Nova solicitação pull , em Revisores, selecione Pesquisar usuários e grupos para adicionar como revisores.
2. À medida que você insere um nome ou endereço de e-mail, uma lista suspensa mostra uma lista de usuários e grupos correspondentes. Selecione nomes na lista para adicionar como revisores opcionais.
3. Para adicionar revisores necessários, selecione Adicionar revisores necessários e, em seguida, selecione Pesquisar para adicionar revisores necessários para pesquisar e selecionar os nomes.

Para adicionar revisores a uma RP existente, execute as seguintes etapas:

1. Na seção Revisores da página Visão geral , selecione Adicionar e, em seguida, selecione Revisor obrigatório ou Revisor opcional.

   

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

   

Para alterar um revisor entre obrigatório e opcional ou para remover um revisor, selecione Mais opções (⋮) à direita do nome do avaliador. Para ver os membros de um grupo ou equipa que estiver como revisor, selecione o ícone do grupo.

Estúdio Visual

Para adicionar revisores, abra a RP no navegador e faça as atualizações na página Visão geral da RP.

Você pode adicionar revisores opcionais a um RP na criação com
az repos pr create --reviewer "<Reviewer Name>" "<Another Reviewer>".

Por exemplo:

az repos pr create --repository Fabrikam --source-branch new --reviewer "[Fabrikam]\Fabrikam Team" "[Fabrikam Fiber]\Web"

Para adicionar revisores obrigatórios ou alterar revisores entre opcional e obrigatório, abra e atualize o PR no navegador.

Para gerenciar revisores para um PR existente, use az repos pr reviewer.

• Para adicionar revisores a uma RP existente, use
  az repos pr reviewer add --id <PR Id> --reviewer "<Reviewer Name>" "<Another Reviewer>".
• Para listar os revisores de um PR, use az repos pr reviewer list --id <PR Id>.
• Para remover revisores de uma RP, use az repos pr reviewer remove --id <PR Id> --reviewer "<Reviewer Name>".

az repos pr reviewer add --id
                         --reviewers
                         [--detect {false, true}]
                         [--org]
                         [--subscription]

Parâmetros

Parâmetro	Descrição
--id	ID da solicitação de pull. Obrigatório.
--reviewers	Utilizadores ou grupos para incluir como revisores num pedido de pull. Espaço separado. Obrigatório.
--detect	Detete automaticamente a organização. Valores aceites: false, true.
--org --organization	URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=<ORG_URL>. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
--subscription	Nome ou ID da assinatura do Azure. Você pode configurar a assinatura padrão usando az account set -s <NAME_OR_ID>.

Vincular itens de trabalho a uma solicitação pull

Browser

Para vincular itens de trabalho a uma nova RP, execute as seguintes etapas:

1. Na página Nova solicitação pull , em Itens de trabalho a serem vinculados, selecione Pesquisar itens de trabalho por ID ou título.
2. Comece a inserir um ID ou título de item de trabalho e selecione o item de trabalho a ser vinculado na lista suspensa exibida.
   • A pesquisa por título retorna itens de trabalho filtrados por estado; todos os itens de trabalho com estados categorizados como Concluído e Removido são excluídos.
   • Esses itens de trabalho também são filtrados por data e usuário, mostrando apenas os itens criados ou atualizados nos últimos 30 dias. Eles devem ser criados, atribuídos ou autorizados como o usuário atual.

Para vincular itens de trabalho a uma RP existente, execute as seguintes etapas:

1. Na guia Visão Geral de Relações Públicas, na área Itens de trabalho , selecione +.

   

2. Insira a ID do item de trabalho ou procure 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. A remoção de um link remove apenas o link entre o item de trabalho e o PR. Os links criados na ramificação ou a partir de confirmações permanecem no item de trabalho.

Estúdio Visual

Para vincular itens de trabalho, abra a RP em seu navegador e faça suas atualizações na página Visão geral da RP.

Pode ligar itens de trabalho do "Azure Boards" a PRs ao criar o PR com az repos pr create --work-items <Id1> <Id2>, onde <Id> é a ID do item de trabalho.

Por exemplo, o comando a seguir vincula os itens de trabalho #63 e #64 a uma nova RP na new ramificação:

az repos pr create --repository Fabrikam --source-branch new --work-items 63 64

Para gerenciar itens de trabalho para um PR existente, use az repos pr work-item.

• Para vincular itens de trabalho a uma RP existente, use az repos pr work-item add --id <PR Id> --work-items <Id1> <Id2>.
• Para listar os itens de trabalho vinculados a uma RP, use az repos pr work-item list --id <PR Id>.
• Para desvincular um item de trabalho de um PR, use az repos pr work-item remove --id <PR Id> --work-items <Id1>. Desvincular apenas remove o link entre o item de trabalho e o PR. Os links criados na ramificação ou a partir de commits permanecem no item de trabalho.

az repos pr work-item add --id
                          --work-items
                          [--detect {false, true}]
                          [--org]
                          [--subscription]

Parâmetros

Parâmetro	Descrição
--id	ID da solicitação de pull. Obrigatório.
--work-items	IDs dos itens de trabalho a serem vinculados. Espaço separado. Obrigatório.
--detect	Detete automaticamente a organização. Valores aceites: false, true.
--org --organization	URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=<ORG_URL>. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
--subscription	Nome ou ID da assinatura do Azure. Você pode configurar a assinatura padrão usando az account set -s <NAME_OR_ID>.

Adicionar tags a uma solicitação pull

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

Para adicionar uma tag ao criar uma RP, digite um nome de tag na seção Tags . Depois de criar o PR, você pode gerenciar tags na seção Tags .

Adicionar anexos para receber solicitações

Pode anexar ficheiros, incluindo imagens, ao seu PR durante ou após a criação. Selecione o ícone de clipe de papel abaixo do campo Descrição ou arraste e solte os arquivos diretamente no campo Descrição do PR.

Alterar a ramificação de destino de uma solicitação pull ativa

Para a maioria das equipes, quase todos os RPs têm como alvo uma ramificação padrão, como main ou develop. Se às vezes você precisa segmentar uma ramificação diferente, é fácil esquecer de alterar a ramificação de destino quando você cria o PR. Se isso acontecer, você pode alterar a ramificação de destino de um RP ativo:

1. Selecione Mais ações no canto superior direito na página Visão geral de RP e, em seguida, selecione Alterar ramificação de destino no menu suspenso.
2. No painel Alterar ramificação de destino , selecione Escolher uma ramificação de destino, selecione a nova ramificação e, em seguida, selecione Alterar.

Enviar notificações de solicitação pull por e-mail para as partes interessadas

Você pode compartilhar uma solicitação pull por e-mail para notificar os revisores e se comunicar com os membros da equipe. Para partilhar um Pull Request (RP):

1. Selecione Mais opções na página Visão geral de PR e, em seguida, selecione Partilhar pedido de pull.

   

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

3. Adicione uma mensagem opcional no campo Nota (Opcional) e, em seguida, selecione Enviar. Os destinatários recebem um e-mail solicitando a sua atenção e fornecendo um link para o PR.

Observação

Ao usar o recurso de e-mail integrado, você só pode enviar e-mails para endereços individuais de membros do projeto. Não há suporte para adicionar um grupo de equipe ou grupo de segurança à linha Para: . Se você adicionar um endereço de e-mail não reconhecido, receberá uma mensagem indicando que um ou mais destinatários não têm permissões para ler a solicitação pull enviada por email.

Próximos passos

Revisar solicitações de pull

Artigos relacionados

• Visualizar pull requests
• Revisar solicitações de pull
• Concluir pull requests
• Alterar a ramificação padrão
• Copiar alterações utilizando cherry-pick
• Saiba mais sobre solicitações pull e permissões