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.
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 PRs, você deve ser membro do projeto Azure DevOps com acesso Básico ou superior. Se você não for um membro do projeto, seja adicionado.
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.
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.
Verifique se você selecionou o repositório correto.
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.
Você pode listar todos os seus RPs em diferentes projetos em sua organização escolhendo Solicitações pull na visualização Meu Trabalho.
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.
Selecione Exibir>Team Explorer para abrir o Team Explorer. Você também pode pressionar Ctrl+\, Ctrl+M.
Em Página inicial, selecione Pull Requests para visualizar listas de RPs abertas por você ou atribuídas a você.
Para exibir a lista de RP no portal da Web do Azure DevOps, selecione Ações e, em seguida, selecione Abrir no navegador.
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
Os comandos da CLI do Azure DevOps não são suportados para o Servidor de DevOps do Azure.
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.
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.
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.
Para filtrar solicitações pull do Visual Studio:
No menu Git, selecione< seu serviço>>Git View Pull Requests.
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.
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
Os comandos da CLI do Azure DevOps não são suportados para o Servidor de DevOps do Azure.
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.
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.
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.
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
Os comandos da CLI do Azure DevOps não são suportados para o Servidor de DevOps do Azure.
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.
