Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Serviços do Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Visual Studio 2019 | Visual Studio 2022
Dica
Você pode usar a IA para ajudar nas tarefas do Azure DevOps. Consulte Ativar assistência de IA com o servidor MCP do Azure DevOps para começar.
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 e responder e resolver os comentários de revisão, consulte Endereçar comentários.
Pré-requisitos
| Categoria | Requirements |
|---|---|
| Acesso ao projeto | Membro de um projeto. |
| Permissões | - Exibir código em projetos privados: pelo menos acesso básico . - Clonar ou contribuir para o código em projetos privados: membro do grupo de segurança Colaboradores ou permissões correspondentes no projeto. - Definir permissões de branch ou repositório: gerenciar permissões para o branch ou repositório. - Defina políticas de ramificação, verificações de status ou altere a ramificação padrão: permissão Editar políticas para o repositório ou a ramificação, ou associação ao grupo de segurança Administradores do Projeto. - Importar um repositório: membro do grupo de segurança Administradores do Projeto ou da permissão Criar repositório no nível do projeto do Git definida como Permitir. Para obter mais informações, consulte Definir permissões do Repositório do Git. |
| Serviços | Repositórios habilitados. |
| Tools | Optional. Use os comandos az repos: CLI do Azure DevOps. |
| Categoria | Requirements |
|---|---|
| Acesso ao projeto | Membro de um projeto. |
| Permissões | - Visualizar código: pelo menos acesso básico. - Clonar ou contribuir com o código: membro do grupo de segurança Colaboradores ou permissões correspondentes no projeto. |
| Serviços | Repositórios habilitados. |
Para obter mais informações sobre permissões e acesso, consulte Permissões padrão de repositório Git e de 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 branch principal e da branch 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.
Revisar 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.
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 branch nas Configurações do Projeto.
Concluir um pull request
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.
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 à branch de destino.
- Definir o preenchimento automático: configure a PR para concluir e mesclar depois de atender a todas as políticas de branch 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.
No painel Concluir solicitação de pull, em Tipo de mesclagem, selecione uma das opções de mesclagem.
- Mesclar (sem avanço rápido): mescle com um histórico não linear que preserva todos os commits.
- Combinar commits: mescle com um histórico linear que combina todos os commits de origem em um único commit no destino ou mescla a 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 com avanço rápido: baseie novamente os commits de origem no destino e avance rapidamente.
- Mesclagem semilinear: baseie novamente commits 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.
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 branch> após a mesclagem: exclua a branch 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.
- Substituir as políticas de branch e habilitar 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 Isenção de cumprimento de políticas.
Selecione Concluir mesclagem.
Quando você concluir a mesclagem, todos os itens de trabalho vinculados são atualizados automaticamente para mostrar a conclusão da PR.
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 branch 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 para resolver conflitos de mesclagem, não será possível fazer o rebase. 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 múltiplas bases de mesclagem
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 de múltiplas bases de mesclagem 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 branch podem entrar em conflito com as alterações em outra branch. 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
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 do PR, o email lhe notificará 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 mais informações, confira Políticas de branch.
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.
Abandonar ou reativar um pull request
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.
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.
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.
No painel Reverter solicitação de pull:
- Em Ramificação de destino, selecione a ramificação em que você deseja desfazer as alterações de PR.
- Em Nome da ramificação do tópico necessário, altere o reverter nome da ramificação de PR, se desejar.
- Selecione Reverter.
Na tela Nova solicitação de pull, selecione Criar.
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.