Exibir, filtrar e abrir solicitações pull

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Você cria solicitações pull (PRs) para revisar e mesclar alterações de código em um repositório Git no Azure Repos. Os membros da equipe e as partes interessadas podem revisar as alterações e dar feedback antes de mesclar o código na ramificação de destino. Os revisores também podem comentar as alterações e votar para aprovar ou rejeitar o código.

As equipes podem exigir RPs para quaisquer alterações em ramificações protegidas e definir políticas de ramificação para exigir que determinadas RPs atendam a critérios específicos.

Há várias maneiras de listar, filtrar, exibir e abrir RPs para um projeto.

Pré-requisitos

• Os repositórios devem estar habilitados em seu projeto. Se o hub Repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço de DevOps do Azure para reativar Repos.

• Para exibir RPs, você deve ser membro do projeto de DevOps do Azure em que o PR está, com acesso Básico ou superior. Se você não for um membro do projeto, seja adicionado.

  Nota

  Para projetos públicos, os usuários com acesso de Partes Interessadas têm acesso total aos Repositórios do Azure.

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

• Nos Serviços de DevOps do Azure, você pode gerenciar PRs e outros recursos da interface de linha de comando (CLI) do Azure com a azure-devops extensão. Para saber como trabalhar com a CLI dos Serviços de DevOps do Azure, consulte Introdução à CLI do Azure DevOps. Os comandos da CLI do Azure Repos para RPs usam az repos pr.

Listar solicitações pull

Você pode listar PRs usando o site do projeto Azure DevOps, o Visual Studio ou a linha de comando do Azure DevOps.

Browser

1. Para listar PRs em um repositório específico em um projeto, vá para esse projeto no portal da Web e selecione Repos>Pull requests.

   

2. Verifique se você selecionou o repositório correto.

   

3. A visualização padrão mostra seus PRs na guia Mine. Selecione Ativo para mostrar todos os PRs ativos para o repositório atual. Selecione Concluído ou Abandonado para exibir listas de RPs fechados.

   Selecione qualquer RP na lista para ir para a página Visão geral desse RP.

   

4. Você pode listar todos os seus RPs em diferentes projetos em sua organização escolhendo Solicitações pull na visualização Meu Trabalho.

   

Visual Studio

Para listar solicitações pull do Visual Studio, no menu Git, selecione< seu serviço>>Git View Pull Requests.

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 do usuário do Team Explorer Git. Para usar o Team Explorer, desmarque Ferramentas>Opções>Visualizar recursos>Nova experiência do usuário do Git na barra de menus. Você pode exercitar os recursos do Git a partir de qualquer interface de forma intercambiável.

Para acessar RPs do 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. Para exibir a lista de RP no portal da Web do Azure DevOps, selecione Ações e, em seguida, selecione Abrir no navegador.

   

CLI do Azure DevOps

Para listar RPs ativos em seu projeto com seus detalhes, use az repos pr list.

az repos pr list [--creator]
                 [--detect {false, true}]
                 [--include-links]
                 [--org]
                 [--project]
                 [--query-examples]
                 [--repository]
                 [--reviewer]
                 [--skip]
                 [--source-branch]
                 [--status {abandoned, active, all, completed}]
                 [--subscription]
                 [--target-branch]
                 [--top]

Parâmetros

Parâmetro	Description
--creator	Limite os resultados para receber solicitações criadas por esse usuário.
--detect	Detete automaticamente a organização. Valores aceites: false, true.
--include-links	Inclua _links para cada solicitação pull.
--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.
--query-examples	String JMESPath recomendada. Você pode copiar uma das consultas e colá-la após o --query parâmetro entre aspas duplas para ver os resultados. Você pode adicionar uma ou mais palavras-chave posicionais para que as sugestões sejam baseadas nessas palavras-chave.
--repository -r	Nome ou ID do repositório.
--reviewer	Limite os resultados para receber solicitações em que esse usuário é um revisor.
--skip	Número de solicitações pull a serem ignoradas.
--source-branch -s	Limite os resultados para receber solicitações originadas dessa ramificação de origem.
--status	Limite os resultados para receber solicitações com esse status. Valores aceites: abandoned, active, all, completed.
--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	Limite os resultados para solicitações de pull direcionadas a essa ramificação.
--top	Número máximo de solicitações pull para listar.

Exemplo

O comando a seguir lista todos os PRs no repositório, independentemente do status, e mostra a saída em uma tabela. O exemplo usa a configuração az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"padrão .

az repos pr list --status all --output table

ID    Created     Creator              Title                                           Status     IsDraft    Repository
----  ----------  -------------------  ----------------------------------------------  ---------  ---------  ------------
11    2021-10-04  jamalh@fabrikam.com  Revert 'Updated parameterized-functions.md'     Completed  False      Fabrikam
10    2021-10-04  jamalh@fabrikam.com  Updated parameterized-functions.md              Completed  False      Fabrikam
9     2021-10-04  ke@fabrikam.com      New pull request                                Completed  False      Fabrikam
8     2021-10-04  jamalh@fabrikam.com  Updated parameterized-functions.md              Abandoned  False      Fabrikam
7     2021-09-30  jamalh@fabrikam.com  Added note-new-git-tool.md to /                 Completed  False      Fabrikam
6     2021-09-29  jamalh@fabrikam.com  Revert 'Added parameterized-functions.md to /'  Abandoned  False      Fabrikam
5     2021-09-29  jamalh@fabrikam.com  Updated README.md                               Completed  False      Fabrikam
4     2021-09-29  jamalh@fabrikam.com  Added parameterized-functions.md to /           Completed  False      Fabrikam
3     2021-09-28  jamalh@fabrikam.com  WIP New file                                    Abandoned  False      Fabrikam
2     2021-09-28  jamalh@fabrikam.com  Update README.md                                Abandoned  False      Fabrikam
1     2021-09-28  jamalh@fabrikam.com  Edit README.md                                  Completed  False      Fabrikam

Definir uma vista de pull request personalizada

Filtrar a lista de RP ajuda você a encontrar e organizar RPs para priorizar os arquivos mais importantes em seu fluxo de trabalho.

Browser

Para filtrar a lista de RP, na página Pull requests , selecione o ícone Filter no canto superior direito. Em seguida, selecione Ramificação de destino ou outro cabeçalho de coluna e selecione a ramificação ou outro valor que você deseja filtrar.

Para personalizar ainda mais a sua vista da lista de RP, selecione Personalizar vista no canto superior direito na página Receber pedidos .

Na página Personalizar modo de exibição, você pode reorganizar as seções de exibição atuais, editá-las ou removê-las. Para criar uma nova seção, selecione Adicionar seção.

Na página Personalizar seção, insira e selecione valores para filtrar a seção por parâmetros, como estado de rascunho ou data de atualização. Você pode escolher se deseja Mostrar solicitações pull que aprovei ou rejeitei em uma guia separada ou Excluir solicitações pull (duplicadas) incluídas nas seções anteriores. Quando terminar de personalizar a vista, selecione Guardar.

Essas exibições personalizadas criam seções separadas e recolhíveis na página de solicitação pull. Essas consultas personalizadas também funcionam em repositórios na guia Minhas solicitações pull da página inicial da organização.

Para alterar os parâmetros das vistas personalizadas, selecione o botão Personalizar junto à vista. Ou selecione Personalizar vista e, no ecrã Personalizar vista , selecione a vista que pretende alterar. Algumas vistas, como Atribuído a mim, não podem ser personalizadas, mas podem ser reorganizadas ou removidas.

Em uma guia Arquivos de RP, você pode usar vários filtros para selecionar arquivos e comentários para avaliações mais rápidas. Selecione Filtrar e, em seguida, selecione entre as opções.

• Palavra-chave: Insira uma palavra-chave.
• Revisado/Não revisado: Todos (padrão), Pendente, Revisado.
• Arquivos comentados: Todos os arquivos (padrão), Arquivos com comentários.
• Comentários: Mostrar (padrão), Novidades, Ocultar.
• Status do comentário: Ativo (padrão), Pendente, Resolvido, Conforme projetado, Não corrigirá, Fechado.
• Comentado por: Todos os comentários (padrão) ou uma pessoa específica.

Você também pode digitar uma cadeia de caracteres no campo Pesquisar para mostrar os resultados correspondentes das opções anteriores.

Visual Studio

Para filtrar solicitações pull do Visual Studio:

1. No menu Git, selecione< seu serviço>>Git View Pull Requests.

2. Filtrar por Autor, Rótulo ou outros atributos.

Na visualização Pull Requests do Team Explorer:

• Selecione Ativo, ou Atribuído a mim ou à minha equipe, para filtrar as listas de RP por status ou atribuição de RP.
• Ou digite o Tipo aqui para filtrar os campos da lista para filtrar as listas de RP por data, autor, ramificação ou outros atributos.

CLI do Azure DevOps

Você pode usar vários parâmetros az repos pr list para filtrar a lista de PRs, como --creator, --project, , --repository, --reviewer, --source-branch, --status, --target-branche --top.

Os --creator valores e podem ser nomes de --reviewer exibição ou endereços de e-mail. O --top parâmetro define o número máximo de RPs a listar.

Por exemplo, para listar detalhes sobre a última RP que você criou, independentemente de seu status, use:

az repos pr list --creator "My Name" --status all --top 1

Abrir um pedido Pull

Quando você abre uma RP do navegador, do Visual Studio ou da CLI do Azure, a página Visão Geral da RP é aberta no navegador.

Browser

Para abrir uma RP no navegador, selecione a RP na lista na página Pull requests . O PR abre a guia Visão geral . A guia Visão geral mostra o título, a descrição, os revisores, os itens trabalhados vinculados, o histórico e o status da RP. Você pode ver um resumo das políticas de filial que estão passando ou falhando e ver os comentários que os revisores fizeram.

Na guia Arquivos PR, você pode revisar as alterações reais nos arquivos PR. Nas guias Atualizações e Confirmações, você pode ver as alterações que o autor fez para atualizar a ramificação de RP.

Visual Studio

Para abrir uma solicitação pull do Visual Studio, no menu Git, selecione <seu serviço>>Git View Pull Requests e, em seguida, selecione uma pull request para abri-la.

Ou, na visualização Pull Requests do Team Explorer, clique com o botão direito do mouse na RP e selecione Abrir no navegador para abrir a RP no portal da Web.

Confira uma filial

No Visual Studio 2019, você pode fazer check-out de uma ramificação de origem de RP diretamente do modo de exibição Pull Requests . Clique com o botão direito do mouse em uma RP e escolha Checkout Source Branch.

Nota

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações para usar a experiência do Git, bem como o Team Explorer. Para obter mais informações, consulte Comparação lado a lado do Git e do Team Explorer.

CLI do Azure DevOps

Para mostrar os detalhes de um único PR, use az repos pr show com o parâmetro necessário --id . Para abrir o PR no seu navegador, use --open.

az repos pr show --id
                 [--detect {false, true}]
                 [--open]
                 [--org]
                 [--query-examples]
                 [--subscription]

Parâmetros

Parâmetro	Description
--id	ID do pull request. Necessário.
--detect	Detete automaticamente a organização. Valores aceites: false, true.
--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/.
--query-examples	String JMESPath recomendada. Você pode copiar uma das consultas e colá-la após o --query parâmetro entre aspas duplas para ver os resultados. Você pode adicionar uma ou mais palavras-chave posicionais para que as sugestões sejam baseadas nessas palavras-chave.
--subscription	Nome ou ID da assinatura do Azure. Você pode configurar a assinatura padrão usando az account set -s <NAME_OR_ID>.

Exemplo

O exemplo a seguir mostra os detalhes do PR #21, mostra a saída do comando como uma tabela e abre o PR no navegador:

az repos pr show --id 21 --open --output table

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

Confira uma filial

Use az repos pr checkout com o parâmetro necessário --id para fazer check-out de uma filial de RP localmente, desde que não haja alterações locais.

az repos pr checkout --id
                     [--remote-name]
                     [--subscription]

Parâmetros

Parâmetro	Description
--id	ID do pull request.
--remote-name	Nome do git remoto contra o qual o PR é levantado. Valor predefinido: origin.
--subscription	Nome ou ID da assinatura do Azure. Você pode configurar a assinatura padrão usando az account set -s <NAME_OR_ID>.

Exemplo

Por exemplo, para verificar a ramificação para PR #21 localmente, use:

az repos pr checkout --id 21

Para rever alterações, fazer comentários ou sugestões, ou aprovar ou votar no PR, consulte Rever pedidos pull.

Ver e atualizar pedidos pull a partir de um dispositivo móvel

Você pode usar dispositivos móveis para exibir todas as telas de RP do Azure Repos e executar ações.

Próximos passos

Ver pedidos Pull

Artigos relacionados

• Criar um pull request
• Notificações de atualização de pedidos Pull
• Concluir um pull request
• Alterar a ramificação padrão
• Copiar alterações com cherry-pick
• Sobre solicitações pull e permissões