Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Você cria solicitações de pull (PRs) para revisar e mesclar alterações de código em um repositório Git no Azure Repos. Os membros da equipe e os stakeholders podem revisar as alterações e fornecer comentários antes de mesclar o código no branch de destino. Os revisores também podem comentar as alterações e votar para aprovar ou rejeitar o código.
As Equipes podem exigir PRs para quaisquer alterações em branches protegidos e definir políticas de branch para exigir que determinadas PRs atendam a critérios específicos.
Há várias maneiras de listar, filtrar, exibir e abrir PRs 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 do Azure DevOps para reabilitar repositórios.
Para examinar PRs, você deve ser membro do projeto do Azure DevOps em que a PR está, com acesso Básico ou superior. Se você não for um membro do projeto, será adicionado.
Observação
Para projetos públicos, os usuários que receberam acesso de Stakeholder têm acesso total a Azure Repos.
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 do Azure DevOps para reabilitar repositórios.
Para exibir as PRs, você deve ser membro do projeto do Azure DevOps com acesso Básico ou superior. Se você não for um membro do projeto, será adicionado.
Para listar PRs em um repositório específico em um projeto, vá para esse projeto no portal da Web e selecioneSolicitações de >Pull do Repositório.
Verifique se você selecionou o repositório correto.
O modo de exibição padrão mostra suas PRs na guia Mine. Selecione Ativo para mostrar todas as PRs ativas para o repositório atual. Selecione Concluído ou Abandonado para exibir listas de PRs fechadas.
Selecione qualquer PR na lista para ir para a página Visão geral dessa PR.
Você pode listar todas as suas PRs em diferentes projetos em sua organização escolhendo Solicitações de pull no modo de exibição Meu Trabalho.
Para listar solicitações de pull do Visual Studio, no menu Git, selecione <seu serviço de Git>>Exibir Solicitações de Pull.
O Visual Studio 2019 versão 16.8 e versões posteriores fornece uma experiência de controle de versão do Git, mantendo a interface do usuário do Team Explorer Git. Para usar o Team Explorer, desmarque Ferramentas>Opções>Versão prévia do recurso>Nova experiência do usuário do Git na barra de menus. Você pode exercer os recursos do Git de qualquer interface de forma intercambiável.
Selecione Exibir>Team Explorer para abrir o Team Explorer. Você também pode pressionar Ctrl+\,Ctrl+M.
Na Página Inicial, selecione Solicitações de Pull para exibir listas de PRs abertas por você ou atribuídas a você.
Para exibir a lista de PR no portal da Web do Azure DevOps, selecione Ações e, em seguida, selecione Abrir no navegador.
Para listar PRs ativas 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
Descrição
--creator
Limite os resultados às solicitações de pull criadas por esse usuário.
--detect
Detectar a organização automaticamente. Valores aceitos:false, true.
--include-links
Inclua _links para cada solicitação de 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>. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. 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>. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git.
--query-examples
Cadeia de caracteres 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 a solicitações de pull em que esse usuário é um revisor.
--skip
Número de solicitações de pull a serem ignoradas.
--source-branch-s
Limite os resultados a solicitações de pull originadas desse branch de origem.
--status
Limite os resultados a solicitações de pull com esse status. Valores aceitos: 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 a solicitações de pull direcionadas a esse branch.
--top
Número máximo de solicitações de pull a serem listadas.
Exemplo
O comando a seguir lista todas as PRs no repositório, independentemente de status, e mostra a saída 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 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
Não há suporte para comandos da CLI do Azure DevOps para Azure DevOps Server.
Definir uma exibição de solicitação de pull personalizada
Filtrar a lista de PR ajuda você a encontrar e organizar PRs para priorizar os arquivos mais importantes em seu fluxo de trabalho.
Para filtrar a lista de PR, na página Solicitações de pull, selecione o ícone Filtro no canto superior direito. Em seguida, selecione Branch de destino ou outro cabeçalho de coluna e selecione o branch ou outro valor que você deseja filtrar.
Para personalizar ainda mais sua exibição da lista de PR, selecione Personalizar exibição no canto superior direito na página Solicitações de pull.
Na página Personalizar exibição, você pode reorganizar as seções do modo de exibição atual, 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 atualizada. Você pode escolher se deseja Mostrar solicitações de pull que aprovei ou rejeitei em uma guia separada ou Excluir solicitações de pull (duplicatas) incluídas nas seções anteriores. Quando terminar de personalizar o modo de exibição, selecione Salvar.
Essas exibições personalizadas criam seções separadas e flexíveis na página de solicitação de pull. Essas consultas personalizadas também funcionam em repositórios na guia Minhas solicitações de pull da página inicial da organização.
Para alterar os parâmetros dos modos de exibição personalizados, selecione o botão Personalizar ao lado do modo de exibição. Ou selecione Personalizar exibição e, na tela Personalizar exibição, selecione o modo de exibição que você deseja alterar. Alguns modos de exibição, como Atribuído a mim, não podem ser personalizados, mas podem ser reorganizados ou removidos.
Em uma guia Arquivos de PR, você pode usar vários filtros para selecionar arquivos e comentários para revisões mais rápidas. Selecione Filtrar e, em seguida, selecione entre as opções.
Palavra-chave: insira um palavra-chave.
Revisado/Não Revisado: Todos (padrão), Pendentes, Revisados.
Arquivos com comentários: todos os arquivos (padrão), Arquivos com comentários.
Status de comentário: Ativo (padrão), Pendente, Resolvido, Como 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 Pesquisa para mostrar os resultados correspondentes das opções anteriores.
Para filtrar solicitações de pull do Visual Studio:
No menu Git, selecione <seu serviço Git>>Exibir Solicitações de Pull.
Filtre por Autor, Etiqueta ou outros atributos.
No modo de exibição Solicitações de Pull do Team Explorer:
Selecione Ativo ou Atribuído a mim ou à minha equipe para filtrar as listas de PR por status de PR ou atribuição.
Ou digite nos campos Digite aqui para filtrar a lista para filtrar as listas de PR por data, autor, branch 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 valores --creator e --reviewer podem ser nomes de exibição ou endereços de e-mail. O parâmetro --top define o número máximo de PRs a serem listados.
Por exemplo, para listar detalhes sobre a última PR que você criou, independentemente de seu status, use:
az repos pr list --creator "My Name" --status all --top 1
Não há suporte para comandos da CLI do Azure DevOps para Azure DevOps Server.
Abrir uma solicitação de pull
Quando você abre uma PR no navegador, no Visual Studio ou na CLI do Azure, a página Visão geral da PR é aberta no navegador.
Para abrir uma PR no navegador, selecione a PR na lista na página Solicitações de pull. A PR é aberta na 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 os status da PR. Você pode ver um resumo das políticas de branch que estão sendo aprovadas ou reprovadas e ver comentários que os revisores fizeram.
Na guia Arquivos da PR, você pode revisar as alterações reais nos arquivos da PR. Nas guias Atualizações e Confirmações, você pode ver as alterações que o autor fez para atualizar o branch da PR.
Para abrir uma solicitação de pull do Visual Studio, no menu Git, selecione <seu serviço Git>>Exibir Solicitações de Pull e selecione uma solicitação de pull para abri-la.
Ou, no modo de exibição Solicitações de Pull do Team Explorer, clique com o botão direito do mouse na PR e selecione Abrir no navegador para abrir a PR no portal da Web.
Fazer check-out de um branch
No Visual Studio 2019, você pode fazer check-out do branch de origem de uma PR diretamente no modo de exibição Solicitações de Pull. Clique com o botão direito do mouse em uma PR e escolha Check-out do Branch de Origem.
Observação
O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu do Git para gerenciar o fluxo de trabalho do Git com menos comutação de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações sobre como 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 uma única PR, use az repos pr show com o parâmetro --id exigido. Para abrir a PR no navegador, use --open.
az repos pr show --id
[--detect {false, true}]
[--open]
[--org]
[--query-examples]
[--subscription]
Parâmetros
Parâmetro
Descrição
--id
ID da solicitação de pull. Obrigatório.
--detect
Detecte automaticamente a organização. Valores aceitos:false, true.
--open
Abra a solicitação de pull no 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>. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.
--query-examples
Cadeia de caracteres 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 da PR nº 21, mostra a saída do comando como uma tabela e abre a 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
Fazer check-out de um branch
Use az repos pr checkout com o parâmetro --id exigido para fazer check-out de um branch de PR localmente, desde que não haja alterações locais.
az repos pr checkout --id
[--remote-name]
[--subscription]
Parâmetros
Parâmetro
Descrição
--id
ID da solicitação de pull.
--remote-name
Nome do git remoto em relação ao qual a PR é gerada. Valor padrão: 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 fazer check-out do branch para PR nº 21 localmente, use:
az repos pr checkout --id 21
Não há suporte para comandos da CLI do Azure DevOps para Azure DevOps Server.
Para revisar as alterações, fazer comentários ou sugestões ou aprovar ou votar na PR, consulte Revisar solicitações de pull.
Exibir e atualizar solicitações de pull de um dispositivo móvel
Você pode usar dispositivos móveis para exibir todas as telas de PR do Azure Repos e executar ações.
