Concluir, abandonar ou reverter solicitações 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 solicitação pull (PR) e a RP atender a todos os requisitos da política de ramificação, você poderá mesclar suas alterações na ramificação de destino e concluir a RP. Ou se decidir não avançar com as alterações no PR, pode abandonar o PR.

Para abordar as alterações dos revisores, responder e resolver comentários de avaliações, consulte Endereçar comentários.

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 concluir seu PR, você deve ser um membro do grupo de segurança Colaboradores , ou ter as permissões correspondentes, no projeto em que o PR está.

• Para contribuir para uma RP, tem de ser membro do grupo de segurança Leitores ou ter as permissões correspondentes.

• Para exibir ou revisar RPs, você deve ter acesso Básico ou superior ao projeto DevOps do Azure.

• Se você não é um membro do projeto para o qual deseja contribuir, seja adicionado.

  Nota

  Para projetos públicos, os usuários com acesso de Partes Interessadas têm acesso total aos Repositórios do Azure.

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

• 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.

Verificar alterações de mesclagem

Quando você conclui um 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 RP. Para ver a confirmação de mesclagem de visualização e verificar se há conflitos de mesclagem, selecione o menu Mais opções no canto superior direito de uma página Visão geral de RP e, em seguida, selecione Exibir alterações de mesclagem.

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

Rever as políticas das sucursais

As equipes podem definir políticas de ramificação que exigem que as RPs em ramificações protegidas atendam a critérios específicos antes que as RPs possam se fundir. Você pode ver as políticas de ramificação em vigor para seu PR, se elas são necessárias para mesclagem e se o PR está passando ou falhando.

Browser

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

Na página Visão Geral de Relações Públicas, os requisitos da política de ramificação têm um ícone. Selecione Mais opções ao lado do requisito e, em seguida, selecione Exibir política para ir para a página Políticas de ramificação da filial em Configurações do projeto.

Visual Studio

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

Para abrir uma RP do Visual Studio, no menu Git, selecione <seu serviço>>Git View Pull Requests e selecione uma solicitação 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 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.

Para acessar RPs do Visual Studio Team Explorer:

1. Conecte-se ao seu projeto a partir do Visual Studio.

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

3. Em Página inicial, selecione Pull Requests para visualizar listas de RPs abertas por você ou atribuídas a você.

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

CLI do Azure DevOps

Para ver todas as políticas de ramificação que estão em vigor para um 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	Description
--id	ID do pull request. Necessário.
--detect	Detete automaticamente a organização. Valores aceites: 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>. 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.
--skip	Número de políticas a ignorar.
--subscription	o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s <NAME_OR_ID>.
--top	Número máximo de políticas a listar.

Exemplo

Por exemplo, para ver as políticas em vigor na RP #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 um pull request

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

Browser

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

   

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

2. No painel Concluir solicitação 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.
   • Squash commit: mescla com um histórico linear que combina todas as confirmações de origem em uma única confirmação no destino, ou squash mescla o PR. Lembre-se de que uma nova confirmação será criada para a ramificação de destino sem manter o histórico de confirmação da ramificação de origem.
   • Rebase e avanço rápido: Rebaseie a fonte confirma no destino e avance.
   • Mesclagem semilinear: a fonte de rebase se confirma no destino e cria uma mesclagem de dois pais.

   Nota

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

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

   • Concluir itens de trabalho associados após a mesclagem: conclua todos os itens de trabalho vinculados.
   • Excluir <nome> da ramificação após a mesclagem: exclua a ramificação de origem do PR após a fusão.
   • Personalizar 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. Forçar a mesclagem mesmo que o PR não satisfaça todas as políticas de filiais. Essa opção só estará disponível se você tiver a permissão Isentar da aplicação da política.

4. Selecione Concluir mesclagem.

Quando você conclui a mesclagem, todos os itens de trabalho vinculados são atualizados automaticamente para mostrar a conclusão da RP.

Visual Studio

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

Para abrir uma RP do Visual Studio, no menu Git, selecione <seu serviço>>Git View Pull Requests e selecione uma solicitação pull para abri-la.

Para acessar RPs do Visual Studio 2019 Team Explorer:

1. Conecte-se ao seu projeto a partir do Visual Studio.

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

3. Em Página inicial, selecione Pull Requests para visualizar listas de RPs abertas por você ou atribuídas a você.

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

CLI do Azure DevOps

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

Por exemplo, para concluir o PR #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 RP ao criar uma RP com az repos pr create, ou atualizar opções de criação em PRs existentes com az repos pr update.

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

• bypass-policy {false, true}: Se deve ignorar quaisquer políticas necessárias e concluir a solicitação pull assim que ela puder ser mesclada.
• bypass-policy-reason: Motivo para ignorar as políticas necessárias.
• delete-source-branch {false, true}: Se a ramificação de origem deve ser excluída após a solicitação pull ter sido concluída e mesclada.
• merge-commit-message: Personalize a mensagem de confirmação de mesclagem.
• squash {false, true}: Se a origem deve ser esmagada em uma única confirmação de destino para mesclagem.
• transition-work-items {false, true}: Se os itens de trabalho vinculados devem ser resolvidos quando a RP é mesclada.

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

Exemplo

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

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

Rebase durante a conclusão do PR

Existem algumas situações em que a rebase durante a conclusão do PR não é possível:

• Se uma política na ramificação de destino proibir o uso de estratégias de rebaseamento, você precisará da permissão Substituir políticas de ramificação para rebasear.
• Se a ramificação de origem de RP tiver políticas, você não poderá rebaseá-la. A rebase 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 poderá rebasear. As resoluções de conflitos aplicadas a uma fusão tripartida raramente são bem-sucedidas ou válidas quando se rebaseia todos os compromissos de RP individualmente.

Em todos esses casos, você ainda pode rebasear sua filial localmente e, em seguida, empurrar para cima ou mesclar suas alterações quando concluir o PR.

Problema de base de várias intercalações

Em alguns casos, um PR tem mais de uma base de mesclagem verdadeira, e essa situação pode causar problemas de segurança. Se os ficheiros no pedido Pull tiverem versões diferentes entre as bases de intercalação, ocorrerá um aviso de bases de intercalação múltiplas. Para obter mais informações e correção, consulte Várias bases de mesclagem.

Resolver conflitos de intercalação

As alterações de arquivo em sua ramificação podem entrar em conflito com 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 do PR. Você deve resolver quaisquer conflitos de mesclagem entre a ramificação de RP e a ramificação de destino antes de poder mesclar uma RP ou definir a RP para preenchimento automático. Para obter instruções sobre como resolver conflitos de mesclagem, consulte Resolver conflitos de mesclagem.

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

Browser

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

Nota

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 filial. Se não vir Definir preenchimento automático, não tem políticas de ramificação. Para obter mais informações, consulte Políticas de filial.

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

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

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

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

Visual Studio

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

Para abrir uma RP do Visual Studio, no menu Git, selecione <seu serviço>>Git View Pull Requests e selecione uma solicitação pull para abri-la.

Para acessar RPs do Visual Studio 2019 Team Explorer:

1. Conecte-se ao seu projeto a partir do Visual Studio.

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

3. Em Página inicial, selecione Pull Requests para visualizar listas de RPs abertas por você ou atribuídas a você.

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

CLI do Azure DevOps

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

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

Abandonar ou reativar uma solicitação pull

Browser

Para abandonar as alterações e a RP sem mesclar, selecione Abandonar na lista suspensa no botão Concluir. Você ainda pode visualizar o PR abandonado e ele permanece vinculado a itens de trabalho.

Para reativar uma RP abandonada a qualquer momento, abra a RP na guia Abandonado na visualização Pull Request e selecione Reativar no canto superior direito.

Visual Studio

Abra uma solicitação pull no portal da Web. Na página Visão geral, selecione Abandonar.

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

CLI do Azure DevOps

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

Reverter uma solicitação pull concluída

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

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

2. No painel Reverter solicitação pull:

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

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

4. Mescle o novo PR para concluir a reversão.

Nota

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

Próximos passos

Copiar alterações com cherry-pick

Artigos relacionados

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