Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Você cria pedidos de pull (PRs) para rever e integrar alterações de código num 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 ramificação exigir que determinadas RPs atendam a critérios específicos.
Há várias maneiras de listar, filtrar, exibir e abrir RPs para um projeto.
Para exibir RPs, seja membro do projeto de DevOps do Azure em que a RP está, com pelo menos acesso ao Básico. Se você não for um membro do projeto, será adicionado.
Observação
Para projetos públicos, os usuários com acesso Stakeholder têm acesso total aos Repositórios do Azure.
Nos Serviços de DevOps do Azure, você pode gerenciar PRs e outros recursos a partir da interface de linha de comando (CLI) do Azure com a extensão azure-devops. 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 PRs 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 Ative 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 do desse PR.
Você pode listar todas as suas solicitações de pull em diferentes projetos na sua organização escolhendo Solicitações de pull na visualização O Meu Trabalho.
Para listar pedidos de pull do Visual Studio, no menu Git, selecione <o seu serviço Git>>Ver pedidos 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 enquanto mantém a interface de usuário do Team Explorer Git. Para usar Team Explorer, desmarque Ferramentas>Opções>Funcionalidades de Pré-visualização>Nova experiência do utilizador do Git na barra de menus. Você pode exercitar os recursos do Git a partir de qualquer interface de forma intercambiável.
Para aceder aos PRs do Visual Studio Team Explorer:
Selecione Exibir>Team Explorer para abrir o Team Explorer. Você também pode pressionar Ctrl+\Ctrl+M.
Em inicial, selecione Pull Requests para visualizar listas de RPs 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 os PRs ativos no seu projeto com os 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 este utilizador.
--detect
Detete automaticamente a organização. Valores aceites: false, true.
--include-links
Inclua _links para cada pull request.
--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 predefinição ou obtido pelo 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>.
Obrigatório se não estiver configurado como padrão ou obtido via git config.
--query-examples
String JMESPath recomendada. Você pode copiar uma das consultas e colá-la após o parâmetro --query 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 pedidos de pull onde este utilizador é 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 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
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 PR, 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 visualização da lista de RP, selecione Personalizar vista no canto superior direito da página de Pull requests.
Na página Personalizar vista , pode reorganizar as seções da vista atual, editá-las ou removê-las. Para criar uma nova seção, selecione Adicionar seção.
Na página da seção Personalizar , 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 separadaou Excluir solicitações pull (duplicatas) 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 funcionam também nos repositórios na guia Pull requests da página inicial da organização.
Para alterar os parâmetros das vistas personalizadas, selecione o botão Personalizar junto à vista. Em alternativa, selecione Personalizar vistae, no Personalizar vista ecrã, selecione a vista que pretende alterar. Algumas vistas, como Atribuído a mim, não podem ser personalizadas, mas podem ser reorganizadas ou removidas.
Na aba Arquivos de PR , você pode usar vários filtros para selecionar arquivos e comentários para revisões mais rápidas. Selecione Filtrare, em seguida, selecione entre as opções.
Palavra-chave: Insira uma palavra-chave.
Revisado/Não revisado: Todos (padrão), Pendentes, Revisado.
Arquivos comentados: Todos os arquivos (padrão), Arquivos com comentários.
Status do comentário: Ativo (padrão), Pendente, Resolvido, Como planejado, Não será corrigido, 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>>Exibir solicitações pull.
Filtre por Autor , Rótulo , ou outros atributos.
A partir da vista do Team Explorer Pull Requests:
Selecione Ativo ou Atribuído a mim ou à minha equipe, para filtrar as listas de RP por status ou atribuição de RP.
Ou introduza nos campos Digite aqui para filtrar a lista para filtrar as listas de PR por data, autor, branch ou outros atributos.
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 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 pull request
Quando você abre uma RP do navegador, do Visual Studio ou da CLI do Azure, a página Visão Geral do de RP é aberta no navegador.
Para abrir um PR no navegador, selecione o PR da lista na página de Pull Requests . O PR abre-se no separador Visão Geral do . O separador Visão Geral do mostra o título do PR, a descrição, os revisores, os itens de trabalho vinculados, o histórico e o estado do PR. 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 aba Arquivos de PR , pode-se rever as alterações reais nos arquivos de PR. Nas guias Atualizações e Confirmações, você pode ver as alterações feitas pelo autor para atualizar a ramificação de RP.
Para abrir um pull request no Visual Studio, no menu Git, selecione <o seu serviço Git>>Ver Pull Requestse, em seguida, selecione um pull request para abri-lo.
Ou, na visualização do Team Explorer Pull Requests, clique com o botão direito do rato no PR e selecione Ver no navegador para abrir o PR 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 da exibição Pull Requests. Clique com o botão direito do mouse em uma RP e escolha Extrair a Ramificação de Origem.
Observação
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 --id necessário. 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
Descrição
--id
Identificador do pedido de pull.
Obrigató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>.
Obrigatório se não estiver configurado como padrão ou definido 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 parâmetro --query 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 --id necessário para extrair localmente uma branch de PR, desde que não haja alterações locais.
az repos pr checkout --id
[--remote-name]
[--subscription]
Parâmetros
Parâmetro
Descrição
--id
ID do pedido de alteração.
--remote-name
Nome do repositório remoto git para o qual o pedido de pull (PR) é criado. 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 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 analisar alterações, fazer comentários ou sugestões, ou aprovar ou votar no pedido de integração, consulte Rever pedidos de integração.
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.
