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.
Azure DevOps Services | Servidor Azure DevOps | Azure DevOps Server 2022 | Azure DevOps Server 2020
Visual Studio 2019 | Visual Studio 2022
Crie PRs (solicitações de pull) para alterar, revisar e mesclar código em um repositório Git . Você pode criar PRs de branches no repositório upstream ou de branches na bifurcação do repositório. Sua equipe pode revisar as PRs e fornecer comentários sobre as alterações. Os revisores podem percorrer as alterações propostas, deixar comentários e votar para aprovar ou rejeitar as PRs. Dependendo de políticas de branch e outros requisitos, sua PR pode precisar atender a vários critérios antes que você possa concluir a PR e mesclar as alterações no branch de destino.
Para obter diretrizes de PR e considerações de gerenciamento, consulte Sobre solicitações de pull.
Pré-requisitos
| Categoria | Requirements |
|---|---|
| Níveis de acesso | - Exibir ou examinar PRs: pelo menos acesso básico. Para projetos públicos, o acesso de stakeholders aos usuários tem acesso total ao Azure Repos. |
| Permissões | - Contribua para uma PR: membro do grupo de segurança Leitores ou permissões correspondentes. - Criar e concluir uma PR: membro do grupo de segurança Colaboradores ou permissões correspondentes. |
| Serviços | Repositórios habilitados. |
| Ferramentas | CLI do Azure DevOps. |
| Categoria | Requirements |
|---|---|
| Níveis de acesso | - Exibir ou examinar PRs: pelo menos acesso básico. |
| Permissões | - Contribua para uma PR: membro do grupo de segurança Leitores ou permissões correspondentes. - Criar e concluir uma PR: membro do grupo de segurança Colaboradores ou permissões correspondentes. |
| 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.
Criar uma solicitação de pull
Você pode criar uma nova PR no site do projeto do Azure DevOps, no Visual Studio ou na CLI do Azure DevOps.
No site do projeto do Azure DevOps, você pode criar uma nova PR de:
- A página Solicitações de Pull.
- Uma ramificação de recurso enviado por push para o repositório.
- Um PR existente, usando cherry-pick.
- O controle de Desenvolvimento em um item de trabalho vinculado do Azure Boards.
Criar uma PR na página Solicitações de pull
Você pode criar PRs para qualquer branch na página Solicitações de pull do projeto na Web.
Na páginaSolicitações> de Pull de Repos, selecione Nova solicitação de pull no canto superior direito.
Selecione o branch com as alterações e o branch no qual você deseja mesclar as alterações, como o branch principal.
Insira seus detalhes de PR e crie o PR.
Criar uma PR com base em um branch enviado por push
Depois de enviar por push ou atualizar um branch de recurso, o Azure Repos exibe um prompt para criar uma PR.
Na página Solicitações de Pull:
Na página Arquivos :
Selecione Criar uma solicitação de pull para ir para uma página em que você pode inserir seus detalhes de PR e criar a PR.
Criar uma PR com base em um item de trabalho vinculado
Você pode criar uma PR diretamente de um item de trabalho Azure Boards vinculado ao branch.
No Azure Boards, em Backlogs ou Consultas no modo de exibição Trabalho , abra um item de trabalho vinculado ao branch.
Na área Desenvolvimento do item de trabalho, selecione Criar uma solicitação de pull.
O link leva você para uma página em que você pode inserir seus detalhes de PR e criar a PR.
Adicionar atualizações com cherry-pick
Copie commits de um branch para outro usando a opção cherry-pick. Ao contrário de uma mesclagem ou troca de base, cherry-pick traz apenas as alterações dos commits selecionados, em vez de todas as alterações em um branch.
Para escolher as alterações de uma PR concluída, selecione Cherry-pick na página Visão geral da PR. Para copiar as alterações de uma PR ativa, selecione Cherry-pick no menu Mais opções da PR. Essa ação cria um novo ramo com as alterações copiadas. Em seguida, você pode criar uma nova PR a partir do novo branch. Para obter instruções detalhadas, consulte Copiar alterações com cherry-pick.
Alternar as branches de origem e destino do seu pull request
Antes de salvar uma PR pela primeira vez, você pode alternar os branches de origem e de destino da PR selecionando o ícone Alternar branches de origem e de destino ao lado dos nomes de branch. Quando a PR estiver ativa, esse ícone desaparecerá, mas você ainda poderá alterar o branch de destino da PR.
Usar modelos de solicitação de pull
Um modelo de solicitação de pull é um arquivo que contém o texto Markdown que preenche a descrição de PR quando você cria uma PR. Boas descrições de RP informam aos revisores de RP o que esperar e podem ajudar a controlar tarefas como adicionar testes de unidade e atualizar a documentação. Sua equipe pode criar um modelo de PR padrão que adiciona texto a todas as novas descrições de PR no repositório. Além disso, você pode selecionar entre modelos específicos de ramificação ou outros modelos definidos por sua equipe. Para obter mais informações sobre como criar e usar modelos de PR, consulte Aprimorar descrições de solicitação de pull usando modelos.
Se o repositório tiver um modelo padrão, todas as PRs no repositório terão o texto de descrição do modelo padrão na criação. Para adicionar outros modelos, selecione Adicionar um modelo e escolha um modelo na lista suspensa. Você pode editar o texto do modelo em sua descrição, removê-lo ou adicionar outro texto.
Criar PRs de rascunho
Se sua PR não estiver pronta para revisão, você poderá criar uma PR de rascunho para indicar o trabalho em andamento. Quando a PR estiver pronta para revisão, você poderá publicá-la e começar ou retomar o processo de revisão completa.
Os PRs de rascunho têm as seguintes diferenças em relação aos PRs publicados:
As políticas de validação de build não são executadas automaticamente. Você pode enfileirar validações de build manualmente selecionando o menu mais opções na PR.
A votação está desabilitada no modo de rascunho.
Os revisores necessários não são adicionados automaticamente. As notificações são enviadas somente aos revisores que você adiciona explicitamente à PR de rascunho.
PRs de rascunho são exibidas na lista de PR com uma notificação rascunho .
Para criar uma PR de rascunho, selecione a seta ao lado de Criar e selecione Criar como rascunho ao criar a PR. Você não precisa usar prefixos de título, como WIP ou DO NOT MERGE.
Quando estiver pronto para que a PR seja revisada e concluída, selecione Publicar no canto superior direito na PR. A publicação de uma PR atribui os revisores necessários, avalia as políticas e inicia a votação.
Para alterar uma PR publicada existente para um rascunho, escolha Marcar como rascunho. Marcar uma PR como rascunho remove todos os votos existentes.
Adicionar ou editar o título e a descrição da solicitação de pull
Na página Nova solicitação de pull , insira um Título e uma Descrição detalhada de suas alterações, para que outras pessoas possam ver quais problemas as alterações resolvem. Em uma nova PR como em PRs existentes, você pode ver os Arquivos e Commits em sua PR em guias separadas. Você pode adicionar revisores, vincular itens de trabalho e adicionar tags ao PR.
Quando estiver pronto para revisar as alterações, selecione Criar para criar a PR.
Não se preocupe se você não tiver todos os itens de trabalho, revisores ou detalhes prontos ao criar sua PR. Você pode adicionar ou atualizar esses itens depois de criar a PR.
Editar título e descrição da PR
Mantenha o título e a descrição de PR atualizados para que os revisores possam entender as alterações na PR.
Você pode atualizar o título de uma PR existente selecionando o título atual e atualizando o texto. Selecione o ícone de Salvar para salvar as alterações, ou selecione o ícone de Desfazer para descartar as alterações.
Edite a descrição da PR selecionando o ícone Editar na seção Descrição .
Adicionar revisores a uma solicitação de pull
Você pode adicionar revisores na seção Revisores de uma PR nova ou existente. Você também pode alterar revisores opcionais para necessários, alterar os revisores necessários para opcionais ou removê-los, a menos que eles sejam exigidos pela política.
As políticas de branch podem exigir um número mínimo de revisores ou incluir automaticamente determinados revisores opcionais ou necessários em PRs. Você não pode remover revisores exigidos pela política de branch, mas pode alterar revisores opcionais para necessários ou removê-los.
Para ver a política de branch que adicionou automaticamente um revisor, selecione mais opções ao lado do revisor na seção Revisores da página Visão Geral de PR.
Se o usuário ou grupo que você deseja examinar sua PR não for membro do seu projeto, adicione-o ao projeto antes de adicioná-lo como revisores.
Para adicionar revisores a uma nova PR, execute as seguintes etapas:
- Na página Nova solicitação de pull , em Revisores, selecione Pesquisar usuários e grupos para adicionar como revisores.
- Conforme você insere um nome ou endereço de e-mail, uma lista suspensa mostra uma lista de usuários e grupos correspondentes. Selecione os nomes da lista a serem adicionados como revisores opcionais.
- Para adicionar revisores necessários, selecione Adicionar revisores necessáriose, em seguida, selecione Pesquisar para procurar e selecionar os nomes dos revisores necessários.
Para adicionar revisores a uma PR existente, execute as seguintes etapas:
Na seção Revisores da página Visão Geral, selecione Adicionar, e então selecione Revisor Necessário ou Revisor Opcional.
À medida que você insere um nome ou endereço de email, uma lista de usuários ou grupos correspondentes é exibida. Selecione os nomes a serem adicionados como revisores.
Para alterar um revisor entre necessário e opcional ou remover um revisor, selecione Mais opções (⋮) à direita do nome do revisor. Para exibir a associação de um grupo ou equipe designada como revisor, selecione o ícone do grupo.
Vincular itens de trabalho a uma solicitação de pull
Para vincular itens de trabalho a uma nova PR, execute as seguintes etapas:
- Na página Nova solicitação de pull, em Itens de trabalho a serem vinculados, selecione Pesquisar itens de trabalho por ID ou título.
- Comece a inserir uma ID ou título de item de trabalho e selecione o item de trabalho a ser vinculado na lista suspensa exibida.
- Pesquisar por título retorna itens de trabalho filtrados por estado; todos os itens de trabalho com estados categorizados como Concluídos e Removidos são excluídos.
- Esses itens de trabalho também são filtrados por data e usuário, mostrando apenas os itens criados ou atualizados nos últimos 30 dias. Eles devem ser criados por, atribuídos ou autorizados como o usuário atual.
Para vincular itens de trabalho a uma PR existente, execute as seguintes etapas:
Na guia Visão geral da PR, na área Itens de trabalho, selecione +.
Insira a ID do item de trabalho ou pesquise o título do item de trabalho. Selecione o item de trabalho na lista exibida.
Remova um link de item de trabalho selecionando o ícone x ao lado do item de trabalho. Remover um link remove apenas o link entre o item de trabalho e o PR. Os links criados no branch ou nos commits permanecem no item de trabalho.
Adicionar tags a um pull request
Use tags para mostrar detalhes importantes e ajudar a organizar PRs. As marcas podem comunicar informações extras aos revisores, como que a PR ainda é um trabalho em andamento ou é um hotfix para uma versão futura.
Para adicionar uma marca ao criar uma PR, digite um nome de marca na seção Marcas . Depois de criar o PR, você pode gerenciar etiquetas na seção Tags.
Adicionar anexos a solicitações de pull
Você pode anexar arquivos, incluindo imagens, ao PR durante ou após a criação. Selecione o ícone de clipe de papel abaixo do campo Descrição ou arraste e solte arquivos diretamente no campo Descrição da PR.
Alterar o branch de destino de uma solicitação de pull ativa
Para a maioria das equipes, quase todas as PRs têm como alvo um branch padrão, como main ou develop. Se às vezes você precisar direcionar um branch diferente, é fácil esquecer de alterar o branch de destino ao criar a PR. Se isso acontecer, você poderá alterar o branch de destino de uma PR ativa:
- Selecione Mais ações no canto superior direito na página Visão geral da PR e, em seguida, selecione Alterar branch de destino no menu suspenso.
- No painel Alterar ramo de destino, selecione Escolher um ramo de destino, escolha o novo ramo e, em seguida, selecione Alterar.
Enviar notificações de solicitação de pull de email para os stakeholders
Você pode compartilhar uma solicitação pull por email para notificar os revisores e se comunicar com os membros da equipe. Para compartilhar uma PR:
Selecione Mais opções na página Visão geral da PR e, em seguida, selecione Compartilhar solicitação de pull.
Na tela Compartilhar solicitação de pull, adicione destinatários digitando seus nomes no campo Para: e selecionando entre os nomes de usuário que aparecem. Você também pode remover destinatários.
Adicione uma mensagem opcional no campo
Observação (Opcional) e selecione Enviar . Os destinatários recebem um email pedindo que prestem atenção e com um link para a PR.
Nota
Ao usar o recurso de email interno, você só pode enviar emails para endereços individuais de membros do projeto. Não há suporte para a adição de um grupo de equipe ou grupo de segurança à linha Para: . Se você adicionar um endereço de email não reconhecido, receberá uma mensagem indicando que um ou mais destinatários não têm permissões para ler a solicitação de pull enviada por email.
Para que o recurso de email funcione, o administrador deve configurar um servidor SMTP.