Ver pedidos Pull

Neste artigo, vai aprender a:

Neste artigo, vai aprender a:

• Os repositórios devem ser habilitados em suas configurações de projeto do Azure DevOps. 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 revisar RPs, você deve ser membro do projeto de DevOps do Azure em que a RP está, com nível de acesso Básico ou superior.

  • Se não tiver um projeto, crie um ou inscreva-se gratuitamente.

  • 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 ser habilitados em suas configurações de projeto do Azure DevOps. 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 revisar PRs, você deve ser membro do projeto Azure DevOps com nível de acesso Básico ou superior. Se você não for um membro do projeto, seja adicionado.

Você pode gerenciar PRs nos Serviços de DevOps do Azure usando a CLI (interface de linha de comando) do Azure DevOps. A CLI do Azure DevOps está disponível quando você instala a CLI do Azure e a extensão do Azure DevOps. Para obter uma lista de comandos da CLI para gerenciar PRs, consulte os az repos pr comandos.

As solicitações pull permitem que os revisores designados examinem, discutam e votem as alterações propostas antes que essas alterações sejam aplicadas a uma ramificação de destino de um repositório. Tenha em mente que, se o desenvolvimento for realizado com os mesmos arquivos em ramificações diferentes, pode haver alterações conflitantes. Nesse caso, é necessário analisar e resolver cuidadosamente esses conflitos. Para fazer isso, pode ser necessário editar manualmente o arquivo para aplicar corretamente as alterações de origem, destino ou ambas as ramificações. Fazer todas as alterações de origem ou destino (o que pode ser feito com um único clique no botão) pode não ser o ideal e pode resultar na perda de algumas alterações necessárias. Isso pode ser feito usando ferramentas ADO ou será mais conveniente usar ferramentas de desenvolvimento (como o Visual Studio).

Para saber mais, consulte Resolver conflitos de mesclagem.

As etapas a seguir descrevem como os revisores de RPs no Azure Repos podem navegar por uma RP para entender as alterações propostas:

1. No navegador da Web, abra o projeto de equipe para sua organização do Azure DevOps. Escolha Repo > Pull requests para listar os PRs. Uma RP recém-aberta assume como padrão a guia Visão geral .

2. A guia Visão geral de uma RP mostra o título, a descrição, os revisores, os itens trabalhados vinculados, o histórico, o status e os comentários. Leia a descrição do PR para ver as alterações propostas. Veja os comentários para entender as questões levantadas por outros revisores.

   Nota

   Cada arquivo é estimado para um número de modificações e é marcado com um sinal de "+" ou um rótulo "renomear, editar" ao lado de seu nome. Quando um arquivo tem mais de 50% de alterações, ele é considerado renomeado. Este é o limite padrão para repositórios git que não podem ser alterados.

   

3. Selecione a guia Arquivos para revisar todas as alterações de conteúdo na ramificação de origem do PR. A vista inicial mostra uma vista resumida de todas as alterações de ficheiros. Escolha o botão Exibir ao lado de um arquivo para exibir apenas as alterações desse arquivo. Se o ficheiro tiver sido modificado, o botão Ver abre uma vista de comparação. Se o arquivo foi adicionado ou excluído, o botão Exibir abre um painel de conteúdo.

   

   Nota

   Por motivos de desempenho, a vista de resumo não mostrará as alterações de um ficheiro com mais de 0,5 MB.

4. Em uma visualização de comparação para um arquivo, você pode selecionar um layout de comparação lado a lado ou embutido .

   

   Gorjeta

   Para qualquer ficheiro com mais de 5 MB, a vista de comparação mostra o conteúdo do ficheiro truncado. Para uma visualização de comparação do conteúdo completo, baixe e revise esses arquivos usando uma ferramenta de comparação local.

   Use a árvore de arquivos à esquerda para exibir outro arquivo ou selecione a raiz da árvore de arquivos para ver uma exibição resumida de todas as alterações de arquivo.

5. Para revisar o conjunto de alterações introduzido por pushes específicos na ramificação de origem, selecione um ou mais conjuntos de alterações na lista suspensa de alterações. Quando você seleciona um ou mais conjuntos de alterações, a visualização de comparação é atualizada para mostrar apenas as alterações dos conjuntos de alterações selecionados. Este recurso é útil quando as alterações foram enviadas para o PR desde a sua última revisão e você só quer ver as novas alterações. A lista suspensa de alterações nomeia cada conjunto de alterações com a mensagem de confirmação da confirmação final em cada operação de push.

   

   Gorjeta

   Mantenha pressionada a tecla Shift ao selecionar vários conjuntos de alterações na lista suspensa de alterações.

6. Escolha a guia Atualizações para visualizar todos os conjuntos de alterações enviados para garantir que você não tenha perdido nenhuma alteração de ramificação de origem. Os conjuntos de alterações são numerados e o conjunto de alterações mais recente aparece no topo da lista. Cada conjunto de alterações mostra as confirmações que foram enviadas por push nessa operação de push. Um conjunto de alterações forçado não substituirá o histórico do conjunto de alterações e aparecerá na lista de conjuntos de alterações da mesma forma que qualquer outro conjunto de alterações.

   

7. Escolha a guia Confirmações para exibir o histórico de confirmações da ramificação de origem depois que ela divergiu da ramificação de destino. O histórico de confirmações na guia Confirmações será substituído se o autor de RP forçar um histórico de confirmações diferente, portanto, as confirmações mostradas na guia Confirmações podem ser diferentes das confirmações mostradas na guia Atualizações .

   

Para fornecer uma imagem rápida do status de RP, a guia Visão Geral de RP resume verificações, requisitos e políticas de ramificação que a RP está passando ou falhando. Em alguns casos, o resumo mostra um trecho da mensagem de falha do log de uma verificação de status. A visão geral lista apenas as políticas com falha, mas você pode ver todas as verificações de políticas aprovadas e reprovadas selecionando Exibir <n> verificações.

Na guia Visão geral de RP, você pode revisar a descrição e os comentários de RP para entender as alterações propostas e ver os problemas levantados por outros revisores.

Autores e revisores de RP podem se comunicar uns com os outros adicionando e respondendo a comentários de RP. Ao revisar um RP, use comentários para apontar problemas com as alterações propostas, sugerir alterações e responder a comentários anteriores. Procure um feedback construtivo que seja preciso e fácil de entender. Dirija-se diretamente aos destinatários usando o arquivo @username. Referenciar itens de trabalho usando #workitemID e outros RPs usando !pullrequestID. Às vezes, os autores de RP criam comentários para si mesmos para fins de documentação.

Fornecer feedback nos comentários

Se seus comentários se aplicarem a uma linha específica ou a um intervalo de linhas em um arquivo, adicione um comentário nesse local dentro do arquivo:

1. Na guia Arquivos de uma RP, passe o mouse sobre a linha em que deseja comentar e selecione o botão de comentário para abrir uma caixa de comentário embutida. Você também pode selecionar várias linhas e, em seguida, selecionar o botão de comentário que aparece quando você passa o mouse sobre essas linhas.

   

2. Digite seu comentário na caixa de comentários e escolha Comentário.

   

Se os comentários se aplicarem a todo o arquivo, adicione um comentário no nível do arquivo selecionando Adicionar comentário no menu de opções do arquivo:

Para fornecer comentários gerais não relacionados a um arquivo específico, adicione um comentário na guia Visão geral :

Os revisores de RP também podem usar comentários para sugerir alterações em linhas de arquivo específicas, conforme descrito na próxima seção.

Sugerir alterações nos comentários

Você pode usar comentários para sugerir texto de substituição para uma ou mais linhas em um arquivo:

1. Na guia Arquivos de uma RP, passe o mouse sobre a linha em que deseja comentar e selecione o botão de comentário para abrir uma caixa de comentário embutida. Você também pode selecionar várias linhas e, em seguida, selecionar o botão de comentário que aparece quando você passa o mouse sobre essas linhas. Se for aceite, o conteúdo sugerido substituirá a linha ou linhas às quais o comentário foi adicionado.

   

2. Selecione o ícone de lâmpada sob a caixa de comentários para fazer as alterações sugeridas na caixa de comentários dentro de um bloco de código cercado e, em seguida, escolha Comentário. Você não verá um ícone de lâmpada se adicionar um comentário ao código original (lado esquerdo) de uma visualização de comparação lado a lado.

   

Os autores de RP podem aceitar a sua sugestão:

1. Escolha Aplicar alterações para preparar a alteração para uma confirmação.

   

2. Escolha Confirmar todas as alterações para confirmar todas as alterações em estágios. Os autores de RP podem desmontar uma sugestão escolhendo Desfazer mudança.

   

Editar ou excluir comentários

Você pode editar ou excluir seu comentário passando o mouse sobre o comentário e escolhendo o ícone de edição ou exclusão :

Curtir comentários

Os autores e revisores de RP podem gostar do seu próprio comentário ou de outra pessoa passando o mouse sobre o comentário e escolhendo o ícone de polegar para cima:

Os comentários com gostos mostram um ícone de polegar para cima preenchido e o número de gostos. Passe o cursor sobre o ícone de polegar para cima para ver a lista de pessoas que curtiram o comentário.

Responder aos comentários

Os autores de RP devem responder aos comentários para que os revisores saibam como estão lidando com o feedback e as sugestões:

1. Para responder a um comentário, digite sua resposta no campo Escrever uma resposta . Dirija-se diretamente aos destinatários usando o arquivo @username. Referenciar itens de trabalho usando #workitemID e outros RPs usando !pullrequestID.

   

2. Depois de inserir a resposta, selecione Responder e resolver se a resposta for final. Caso contrário, selecione Responder.

   

   Se você selecionar Responder e resolver, o status do comentário será alterado para Resolvido. Os autores de RP também podem alterar diretamente o status de um comentário, conforme descrito na próxima seção.

Alterar o status do comentário

Novos comentários inicialmente têm um status Ativo , que os autores de RP atualizam durante o processo de revisão para indicar como eles abordaram o feedback e as sugestões dos revisores. Os autores de RP podem selecionar um status de comentário na lista suspensa de status:

• Ativo: o status padrão para novos comentários.

• Pendente: o assunto neste comentário está sob revisão e aguarda outra coisa.

• Resolvido: o problema neste comentário foi resolvido.

• Não vai corrigir: o problema neste comentário é observado, mas não será corrigido.

• Encerrado: está encerrada a discussão neste comentário.

Os autores e revisores de RP podem acompanhar o progresso de RP filtrando o status dos comentários, conforme descrito na próxima seção.

Adicione comentários a um RP para fazer sugestões, responder a comentários anteriores e apontar problemas com as alterações propostas.

• Comente embutido na guia Arquivos de um PR passando o mouse sobre a linha que você deseja comentar e selecionando o botão de comentário .

  

• Dê feedback não vinculado a uma linha de código específica comentando na guia Visão geral .

• Dirija-se ao autor ou a outros revisores diretamente em seus comentários usando @username, e faça referência a itens de trabalho usando #workitemID. Você também pode fazer referência a outros RPs usando !pullrequestID.

Editar, excluir ou curtir um comentário

Para editar ou excluir seu comentário, passe o mouse sobre o comentário e selecione o ícone de lápis para editar o comentário ou o ícone de lixo para excluir o comentário.

Para curtir o seu comentário ou o de outra pessoa, passe o mouse sobre o comentário e selecione o ícone de polegar para cima. Os comentários com gostos mostram um ícone preenchido e o número de gostos na lista de comentários. Passe o cursor sobre o ícone para ver a lista de pessoas que curtiram o comentário.

Curtir um comentário

Para curtir um comentário que você ou outra pessoa fez, selecione o ícone de coração. Passe o cursor sobre o ícone nos comentários para ver a lista de pessoas que curtiram o comentário.

Você pode selecionar quais comentários ou atualizações são exibidos na guia Visão geral selecionando uma opção de filtro na lista suspensa do filtro de comentários. Por exemplo, selecione a opção Filtro Novidades para ver novos comentários e atualizações desde a última vez que abriu o PR. Cada opção de filtro mostra o número de itens para sua categoria.

Você pode selecionar quais comentários e atualizações são exibidos na guia Visão geral . Ocultar alguns comentários e atualizações os tira do caminho ao revisar o código pela primeira vez. Você também pode mostrar apenas o que há de novo desde a última vez que visitou o PR.

Para filtrar comentários e atualizações, selecione o botão Mostrar tudo (n) acima da lista de comentários e selecione uma das opções de filtragem. O modo de exibição muda para mostrar apenas os comentários e atualizações selecionados. O rótulo do botão muda para mostrar os critérios de filtragem e o número de itens mostrados.

Endereço comentários

Você pode fazer atualizações rápidas para sua filial diretamente da guia Arquivos em Código na Web.

Responder e resolver comentários

Responda aos comentários e atualize o status dos comentários para que os revisores saibam como você está lidando com seus comentários e sugestões.

• Para resolver um comentário sem responder, selecione Resolver sob o comentário.
• Para responder ao comentário, digite sua resposta no campo Escrever uma resposta e selecione Responder.
• Para responder e resolver o comentário, digite sua resposta no campo Escrever uma resposta e selecione Responder e resolver.
• Responda a revisores específicos usando @username na resposta e faça referência a itens de trabalho usando #workitemID. Você também pode fazer referência a outros RPs usando !pullrequestID.

Novos comentários começam no status Ativo . Selecione Resolver ou Responder & resolver para atualizar o status do comentário para Resolvido.

Mais opções estão disponíveis na lista suspensa de resolução de comentários:

• Ativo: O comentário ainda está em análise.
• Pendente: O problema neste comentário será resolvido, mas ainda não foi corrigido.
• Resolvido: O problema levantado neste comentário foi corrigido.
• Não vai corrigir: A sugestão no comentário é anotada, mas este PR não vai abordá-la.
• Encerrado: Está encerrada a discussão para este comentário.

Para controlar os ficheiros que já foram revistos, selecione Mais opções junto a um ficheiro no seu PR e, em seguida, selecione Marcar como revisto.

Editar ficheiros

Por conveniência, os autores de RP podem editar arquivos diretamente no Azure Repos. Por exemplo, você pode ter aceitado a alteração de código sugerida por um revisor e desejar fazer alterações semelhantes em outro lugar.

1. Escolha Repos > Files, selecione a ramificação de origem PR, selecione um arquivo e, em seguida, escolha Editar.

   

2. Faça as alterações no editor e escolha Confirmar para abrir a caixa de diálogo Confirmar .

   

3. Na caixa de diálogo Confirmar, edite a mensagem de confirmação, se necessário, e escolha Confirmar para confirmar e enviar as alterações para o PR.

   

Rastrear arquivos revisados

Os revisores de RP podem acompanhar os arquivos revisados escolhendo Marcar como revisado no menu de opções de arquivo ou marcando a caixa de seleção ao lado de um arquivo ou pasta:

Conclua um PR

Os autores de RP podem selecionar uma opção de resolução de RP:

• Completo: conclua o PR agora se todos os revisores necessários o aprovarem e todas as políticas de ramificação necessárias forem atendidas.

• Definir preenchimento automático: preencha automaticamente o PR quando todos os revisores necessários o aprovarem e todas as políticas de ramificação necessárias forem atendidas.

• Marcar como rascunho: defina o PR como status de rascunho para indicar que ele não está pronto para revisão. Para um rascunho de RP, você pode selecionar Publicar para remover seu status de rascunho e marcá-lo pronto para revisão.

• Abandonar: fechar o PR. Para um PR abandonado, você pode selecionar Reativar para restaurá-lo.

Para obter mais informações sobre como concluir uma RP, consulte Concluir a solicitação pull.