Concluir, abandonar ou reverter solicitações de pull

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Depois que todos os revisores necessários aprovarem sua PR (solicitação de pull) e a PR atender a todos os requisitos de política de ramificação, você poderá mesclar suas alterações na ramificação de destino e concluir a PR. Ou, se você decidir não prosseguir com as alterações na PR, é possível abandonar a PR.

Para abordar as alterações dos revisores, responder e resolver comentários de revisão, consulte Comentários de endereço.

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 os repositórios.

• Para concluir sua PR, você deve ser membro do grupo de segurança dosColaboradores ou ter as permissões correspondentes no projeto em que a PR está.

• Para contribuir com uma PR, você deve ser membro do grupo de segurança Leitores ou ter as permissões correspondentes.

• Para exibir ou examinar PRs, você deve ter um acessoBásico ou superior ao projeto do Azure DevOps.

• Se você não for membro do projeto para o qual deseja contribuir, será adicionado.

  Observação

  Para projetos públicos, os usuários que receberam acesso de Stakeholder têm acesso total a Azure Repos.

• Para saber mais sobre permissões e acesso, consulte Permissões padrão de repositório Git e branch e Sobre níveis de acesso.

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

Verificar alterações de mesclagem

Quando você conclui uma PR, o Git adiciona uma nova confirmação de mesclagem ao final da ramificação principal. Essa confirmação de mesclagem vincula os históricos anteriores da ramificação principal e da ramificação de origem de PR. Para ver a confirmação de mesclagem de visualização e marcar os conflitos de mesclagem, selecione o menu Mais opções no canto superior direito em uma página Visão geral de PR e, em seguida, selecione Exibir alterações de mesclagem.

Se você alterou a ramificação de destino depois de criar a PR, selecione Reiniciar mesclagem para criar uma nova confirmação de mesclagem de visualização e atualizar a exibição de comparação de alteração de mesclagem.

Examinar políticas de ramificação

O Teams pode definir políticas de ramificação que exigem PRs em ramificações protegidas para atender a critérios específicos antes que as PRs possam ser mescladas. Você pode ver as políticas de ramificação em vigor para sua PR, se elas são necessárias para mesclagem e se a PR está passando ou falhando.

Navegador

A guia Visão geral de PR resume as políticas de ramificação que estão passando ou falhando para a PR. A visão geral lista apenas políticas com falha, mas você pode ver todas as verificações de política aprovadas e com falha, selecionando Exibir <n> verificações.

Na página Visão Geral de PR, os requisitos de política de ramificação têm um ícone . Selecione Mais opções ao lado do requisito e selecione Exibir política para ir à página Políticas de Ramificação da ramificação nas Configurações do Projeto.

Visual Studio

Você pode abrir uma PR no Visual Studio e examinar as políticas de ramificação, conforme descrito na guia Navegador.

Para abrir uma solicitação de pull do Visual Studio, no menu Git, selecione o seu serviço<Git>>Exibir Solicitações de Pull e selecione uma solicitação de pull para abri-la.

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.

Para acessar PRs do Visual Studio Team Explorer:

1. Conecte-se ao seu projeto por meio do Visual Studio.

2. Selecione Exibir>Team Explorer para abrir o Team Explorer. Você também pode pressionar Ctrl+\,Ctrl+M.

3. Na Página Inicial, selecione Solicitações de Pull para exibir listas de PRs abertas por você ou atribuídas a você.

4. Para abrir uma PR no portal da Web e exibir as políticas em vigor, clique com o botão direito do mouse na PR e selecione Abrir no navegador.

CLI do Azure DevOps

Para ver todas as políticas de ramificação que estão em vigor para uma PR, use az repos pr policy list com o parâmetro necessário id.

az repos pr policy list --id
                        [--detect {false, true}]
                        [--org]
                        [--query-examples]
                        [--skip]
                        [--subscription]
                        [--top]

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.
--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.
--skip	Número de políticas a serem ignoradas.
--subscription	Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s <NAME_OR_ID>.
--top	Número máximo de políticas a serem listadas.

Exemplo

Por exemplo, para ver as políticas em vigor na PR nº 28, execute o seguinte comando:

az repos pr policy list --id 28 --output table

Evaluation ID                         Policy                                         Blocking    Status    Expired    Build ID
------------------------------------  ---------------------------------------------  ----------  --------  ---------  ----------
84e7ca6d-0b42-4819-9f62-f41df5e319f3  Minimum number of reviewers (1)                True        Approved
1ba061d8-9e9f-401b-ab61-e2ed1c200aba  Required reviewers (1)                         True
37620a4b-adc4-483d-9ca2-3f4e6ffe2990  Comment requirements                           False       Approved
34b7cae8-812a-4c14-9229-f71a0e662e8b  Required reviewers (1) ([Fabrikam Fiber]\Web)  False
a6e4380e-9f38-4aa5-863c-0fc496027362  Work item linking                              False       Rejected

Concluir uma solicitação de pull

Depois que você resolve quaisquer conflitos de mesclagem e a PR atender a todas as políticas de ramificação e tiver todas as aprovações necessárias, você poderá concluir a PR.

Navegador

1. Selecione Concluir no canto superior direito para concluir a PR. Ou selecione a seta suspensa ao lado do botão Concluir e selecione uma das opções.

   

   • Concluir: conclua a PR agora e mescle as alterações à ramificação de destino.
   • Definir o preenchimento automático: configure a PR para concluir e mesclar depois de atender a todas as políticas de ramificação necessárias.
   • Marcar como rascunho: retorne o PR ao status do projeto e remova todos os votos.
   • Abandonar: feche a PR sem mesclar as alterações.

2. No painel Concluir solicitação de pull, em Tipo de mesclagem, selecione uma das opções de mesclagem.

   

   • Mesclar (sem avanço rápido): mesclar com um histórico não linear que preserva todas as confirmações.
   • Confirmação de squash: mesclar com um histórico linear que combina todas as confirmações de origem em uma única confirmação no destino ou mescla o PR. Lembre-se de que um novo commit será criado para a ramificação de destino sem manter o histórico de confirmação da ramificação de origem.
   • Basear novamente e avançar rapidamente: basear novamente os commits de origem no destino e avançar rapidamente.
   • Mesclagem semilinear: a origem de trocar base confirma-se no destino e cria uma mesclagem de dois pais.

   Observação

   As políticas existentes são impostas. Por exemplo, se a ramificação tiver atualmente uma política de "somente mesclagem combinação por squash", você precisará alterar essa política se quiser usar outro tipo de mesclagem.

3. Selecione qualquer uma das seguintes opções pós-conclusão. Algumas opções não estão disponíveis para alguns tipos de mesclagem.

   • Conclua os itens de trabalho associados após a mesclagem: conclua todos os itens de trabalho vinculados.
   • Excluir <o nome da ramificação> após a mesclagem: exclua a ramificação de origem da PR após a mesclagem.
   • Personalizar a mensagem de confirmação de mesclagem: adicione uma mensagem de confirmação de mesclagem personalizada. Se você selecionar essa opção, atualize a mensagem de confirmação de mesclagem.
   • Substitua as políticas de ramificação e habilite a mesclagem. Force a mesclagem mesmo se a PR não atender a todas as políticas de ramificação. Essa opção só estará disponível se você tiver a permissão isenta de imposição de política.

4. Selecione Concluir mesclagem.

Quando você concluir a mesclagem, todos ositens de trabalho vinculados são atualizados automaticamente para mostrar a conclusão da PR.

Visual Studio

Para concluir uma PR, abra a PR no navegador e, na página Visão geral, selecione Concluir ou definir outras opções.

Para abrir uma solicitação de pull do Visual Studio, no menu Git, selecione o seu serviço<Git>>Exibir Solicitações de Pull e selecione uma solicitação de pull para abri-la.

Para acessar PRs do Visual Studio Team Explorer:

1. Conecte-se ao seu projeto por meio do Visual Studio.

2. Selecione Exibir>Team Explorer para abrir o Team Explorer. Você também pode pressionar Ctrl+\,Ctrl+M.

3. Na Página Inicial, selecione Solicitações de Pull para exibir listas de PRs abertas por você ou atribuídas a você.

4. Para abrir uma PR no portal da Web, clique com o botão direito do mouse na PR e selecione Abrir no navegador.

CLI do Azure DevOps

Para concluir uma PR e mesclar as alterações, use az repos pr update para atualizar a PR --status para completed.

Por exemplo, para concluir a PR nº 21, use:

az repos pr update --id 21 --status completed

Definir opções de conclusão

Você pode definir opções de conclusão de PR ao criar uma PR com az repos pr createou atualizar opções de criação em PRs existentes com az repos pr update.

As opções de conclusão de PR incluem:

• bypass-policy {false, true}: se deseja ignorar as políticas necessárias e concluir a solicitação de pull depois que ela puder ser mesclada.
• bypass-policy-reason: motivo para ignorar as políticas necessárias.
• delete-source-branch {false, true}: se deseja excluir a ramificação de origem depois que a solicitação de pull for concluída e mesclada.
• merge-commit-message: personalize a mensagem do commit de mesclagem.
• squash {false, true}: se deseja combinação por squash a origem é confirmada em um único commit de destino para mesclagem.
• transition-work-items {false, true}: se deve resolve itens de trabalho vinculados quando a PR é mesclada.

Para definir as opções de conclusão e concluir uma PR existente, use az repos pr update com o parâmetro necessário id .

az repos pr update --id
                   [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--org]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--subscription]
                   [--title]
                   [--transition-work-items {false, true}]

Parâmetros

Parâmetro	Descrição
--id	ID da solicitação de pull. Obrigatório.
--auto-complete	Defina a solicitação de pull para ser concluída automaticamente quando todas as políticas tiverem passado e a ramificação de origem puder ser mesclado na ramificação de destino. Valores aceitos: false, true.
--bypass-policy	Ignore as políticas necessárias e conclua a solicitação de pull assim que ela for mesclada. Valores aceitos: false, true.
--bypass-policy-reason	Motivo para ignorar as políticas necessárias.
--delete-source-branch	Exclua o branch de origem depois que a solicitação de pull for concluída e mesclada no branch de destino. Valores aceitos: false, true.
--description -d	Nova descrição da solicitação de pull. Pode incluir Markdown. Cada valor é uma nova linha. Por exemplo: --description "First Line" "Second Line".
--detect	Detecte automaticamente a organização. Valores aceitos: false, true.
--draft	Converta a PR no modo de rascunho ou publique-a. Valores aceitos: false, true.
--merge-commit-message	Mensagem a ser exibida quando os commits são mesclados.
--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/.
--squash	Esmague os commits no branch de origem ao mesclar no branch de destino. Valores aceitos: false, true.
--status	Defina o novo estado da solicitação de pull. Valores aceitos: abandoned, active, completed.
--subscription	Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s <NAME_OR_ID>.
--title	Novo título para a solicitação de pull.
--transition-work-items	Transfira todos os itens de trabalho vinculados à solicitação de pull para o próximo estado lógico, por exemplo Resolvido. Valores aceitos: false, true.

Exemplo

O exemplo a seguir conclui a PR nº 21, exclui sua ramificação de origem, resolve seus itens de trabalho vinculados e adiciona uma mesclagem mensagem da confirmação:

az repos pr update --id 21 --status completed --delete-source-branch true --transition-work-items true --merge-commit-message "This update is complete."

Trocar base durante a conclusão de PR

Há algumas situações em que a troca de base durante a conclusão da PR não é possível:

• Se uma política na de destino proibir o uso de estratégias de troca de base, você precisará da permissão substituir políticas de ramificação para trocar base novamente.
• Se a ramificação de origem de PR tiver políticas, você não poderá trocar a base dele. A troca de base modificaria a ramificação de origem sem passar pelo processo de aprovação da política.
• Se você usou a Extensão de Conflito de Mesclagem para resolver conflitos de mesclagem, não será possível trocar a base novamente. As resoluções de conflito aplicadas a uma mesclagem de três vias raramente são bem-sucedidas ou válidas ao trocar a base de todas as confirmações de PR individualmente.

Em todos esses casos, você ainda pode trocar a base de sua ramificação localmente e, em seguida, efetuar push upstream ou mesclar suas alterações ao concluir a PR.

Problema de base de mesclagem múltipla

Em alguns casos, uma PR tem mais de uma base de mesclagem verdadeira e essa situação pode causar problemas de segurança. Se os arquivos na PR tiverem versões diferentes entre as bases de mesclagem, um aviso base de mesclagem múltipla será exibido. Para obter mais informações e correção, consulte Várias bases de mesclagem.

Resolver conflitos de mesclagem

As alterações de arquivo em sua ramificação podem entrar em conflito com as alterações em outra ramificação. Quando não está claro como mesclar alterações, o Git mostra os arquivos que entram em conflito na página Visão Geral da PR. Você deve resolver quaisquer conflitos de mesclagem entre a ramificação de PR e a ramificação de destino antes de mesclar uma PR ou definir a PR para preenchimento automático. Para obter instruções sobre como resolver conflitos de mesclagem, consulte Resolver conflitos de mesclagem.

Definir uma solicitação de pull para preenchimento automático

Navegador

Selecione Definir preenchimento automático na lista suspensa Concluir para concluir e mesclar as alterações de PR assim que as condições atenderem a todas as políticas de ramificação. Quando a PR for concluída, você receberá uma notificação por email. Se um conflito ou erro impedir a conclusão da PR, o email notificará você sobre o problema.

Observação

A opção Definir preenchimento automático está disponível no Azure Repos e no TFS 2017 e superior quando você tem políticas de ramificação. Se você não vir Definir preenchimento automático, não terá nenhuma política de ramificação. Para saber mais, confira Definir políticas de ramificação.

Por padrão, uma PR definida como preenchimento automático aguarda apenas as políticas necessárias. No painel Habilitar preenchimento automático, você também pode optar por aguardar políticas opcionais.

A partir do TFS 2018 Atualização 2, a página Visão geral de PR exibe a lista de critérios de política pendentes que a PR está aguardando. Se você definir uma política para ser necessária no painel Habilitar conclusão automática, poderá defini-la de volta como opcional na página Visão geral.

Selecione Cancelar preenchimento automático para desativar o preenchimento automático.

Um conjunto de PR para preenchimento automático exibe um selo de preenchimento automático na página Solicitações de pull.

Visual Studio

Crie uma solicitação de pull no portal da web. Na página Visão geral, selecione Definir preenchimento automático.

Para abrir uma solicitação de pull do Visual Studio, no menu Git, selecione o seu serviço<Git>>Exibir Solicitações de Pull e selecione uma solicitação de pull para abri-la.

Para acessar PRs do Visual Studio Team Explorer:

1. Conecte-se ao seu projeto por meio do Visual Studio.

2. Selecione Exibir>Team Explorer para abrir o Team Explorer. Você também pode pressionar Ctrl+\,Ctrl+M.

3. Na Página Inicial, selecione Solicitações de Pull para exibir listas de PRs abertas por você ou atribuídas a você.

4. Para abrir uma PR no portal da Web e exibir as políticas em vigor, clique com o botão direito do mouse na PR e selecione Abrir no navegador.

CLI do Azure DevOps

Defina o preenchimento automático para concluir uma PR automaticamente quando ela passar todas as aprovações e políticas de ramificação necessárias. Você pode definir o preenchimento automático na criação de PR ou atualizar uma PR existente.

• Para definir o preenchimento automático na criação de PR, use az repos pr create --auto-complete true.
• Para atualizar uma PR existente para preenchimento automático, use az repos pr update --id <PR Id> --auto-complete true.

Abandonar ou reativar uma solicitação de pull

Navegador

Para abandonar suas alterações e sua PR sem mesclagem, selecione Abandonar na lista suspensa no botão Concluir. Você ainda pode exibir a PR abandonada e ela permanece vinculada a itens de trabalho.

Para reativar uma PR abandonada a qualquer momento, abra a PR na guia Abandonado no modo de exibição Solicitação de Pull e selecione Reativar no canto superior direito.

Visual Studio

Crie uma solicitação de pull no portal da web. Na página Visão Geral, selecione Abandonar.

Para abrir a PR no portal da Web, use o procedimento em Concluir uma solicitação de pull.

CLI do Azure DevOps

Para abandonar uma PR sem mesclar as alterações, use az repos pr update --id <PR Id> –-status abandoned. Você pode reativar a PR definindo o status como active.

Reverter uma solicitação de pull concluída

Para desfazer as alterações de uma PR, siga estas etapas. Para obter mais informações, consulte Desfazer alterações.

1. Abra a PR concluída e selecione Reverter. Essa ação cria uma nova ramificação com alterações que desfazem a PR em uma ramificação de destino existente em seu repositório.

2. No painel Reverter solicitação de pull:

   1. Em Ramificação de destino, selecione a ramificação em que você deseja desfazer as alterações de PR.
   2. Em Nome da ramificação do tópico necessário, altere o reverter nome da ramificação de PR, se desejar.
   3. Selecione Reverter.

3. Na tela Nova solicitação de pull, selecione Criar.

4. Mescle a nova PR para concluir o reverter.

Observação

A ramificação criado durante essa reversão tem uma única confirmação que reverte todas as alterações de arquivo da PR original. A ramificação não contém uma confirmação revertida para cada um das confirmações na PR original.

Próximas etapas

Copiar alterações com cherry-pick

Artigos relacionados

• Notificações de atualização de solicitação de pull
• Sobre solicitações e permissões de pull