Adicionando regras de aprovação de pull requests

Escrito para a interface antiga

Este artigo foi escrito para a interface antiga. As instruções ainda podem ser usadas, mas as capturas de tela estão desatualizadas. Em alguns casos, os itens referenciados nas instruções foram movidos ou alterados. Se você não conseguir encontrar um item, consulte o Para onde foi artigo.

Visão geral

Este artigo explica como uma Regra de Aprovação de Pull Request funciona e como adicionar uma. Por padrão, um Pull Request não exige nenhuma revisão antes de poder ser mesclado. Com uma Regra de Aprovação de Pull Request, os administradores podem impor um número mínimo de aprovações antes que um Pull Request possa ser mesclado. Cada regra define a quais branches ela se aplica e quantas aprovações são necessárias. A branch de destino de um Pull Request determina quantas aprovações ele exige.

A regra pode ser configurada com diferentes escopos:

• Todas as branches: A regra se aplica a qualquer branch não coberta por uma regra mais específica.
• Selecione: A regra se destina a uma ou mais branches selecionadas explicitamente.
• Padrão: A regra usa sintaxe de curinga para corresponder branches por convenção de nomenclatura (por exemplo, feature/*, release/v*, hotfix-*).

Substituir Regra de Aprovação de Pull Request

Uma Regra de Aprovação de Pull Request não pode ser substituída. Quando a regra se aplica à branch de destino, o Pull Request não pode ser mesclado até que o número necessário de revisores o aprove. Essa imposição é intencional. No entanto, há duas formas aprovadas de contornar uma Regra de Aprovação de Pull Request:

• Execute um Mesclagem Inteligente, que não exige revisão.
• Altere a Regra de Aprovação de Pull Request.

Exemplo de Pull Request

A captura de tela a seguir mostra um Pull Request com uma Regra de Aprovação aplicada.

Hierarquia de Regras

Quando as branches selecionadas de uma regra se sobrepõem às de outra regra, a precedência determina qual regra se aplica à branch sobreposta. A ordem de precedência, da mais alta para a mais baixa, é:

• Selecione > Padrão > Todas as branches

A captura de tela a seguir mostra duas regras: uma se aplica a Todas as branches, e a outra se aplica somente à main branch. Como a Selecione regra tem precedência sobre a Todas as branches regra, qualquer Pull Request que tenha como destino a main branch requer 3 aprovações em vez de 1 aprovação exigida para outras branches.

Casos especiais

A Selecione A opção não permite atribuir a mesma branch a mais de uma regra. Isso evita conflitos, como uma regra exigindo três aprovações para a branch X enquanto outra exige apenas uma.

A Padrão A opção não permite salvar várias regras com padrões sobrepostos. Por exemplo, você não pode salvar tanto feature/* e feature/new*, porque o feature/* padrão já contém o feature/new* padrão.

Adicionando Regras de Aprovação

1

Ativar Regras de Aprovação

1. Clique em Configurações no menu lateral esquerdo.
2. Clique na Geral guia.
3. Clique em Solicitações de Pull Request.

   
4. Se estiver desativado, clique na Ativar chave para ativar as regras de aprovação.

   

2

Selecionar Branches

Há três métodos para selecionar a quais branches a Regra de Aprovação se aplicará.

Todas as branches

Esta seleção aplica a regra a todas as branches em seu tenant do DevOps.

1. Selecione o Todas as branches opção.

Selecione

Esta seleção aplica a regra somente às branches que você selecionar na lista.

1. Selecione o Selecione opção.
2. Clique na Selecionar branches menu suspenso.
3. Selecione cada uma das branches às quais aplicar esta regra.

   

Cada branch selecionada mostra uma marca de seleção à direita. A lista suspensa também exibe o número de branches selecionadas e disponíveis. Se você tiver muitas branches, use a caixa de pesquisa para encontrá-las.

Padrão

Esta seleção aplica a regra a quaisquer branches que correspondam ao padrão que você inserir. Você pode adicionar o caractere curinga ao final de um padrão (*) para corresponder a branches que começam com o seu padrão e terminam com quaisquer outros caracteres. Por exemplo, se você usar o padrão feature/*, a tabela abaixo mostra como esta regra afeta suas branches.

Ramificações	Regra aplicada
main
feature/addAccount
feature/removeAccount
release/v1.2.3

1. Selecione o Padrão opção.
2. Digite o padrão a ser usado para esta regra na caixa de texto.

   

3

Definir contagem de aprovações

A Contagem de aprovações é o número de revisores que devem aprovar um Pull Request antes que ele possa ser mesclado. A contagem deve ser no mínimo 1.

1. Digite o número de aprovações exigidas para esta regra em Contagem de aprovações caixa de texto.

   

4

Adicionar regras

Você pode adicionar várias Regras de Aprovação às Configurações de Pull Requests. Para saber qual regra se aplica a uma branch selecionada por várias regras, consulte a Hierarquia de Regras seção acima.

1. Clique em Adicionar regra.

   
2. Configure a seleção de branches e a contagem de aprovações da regra usando as instruções acima.

   

5

Salvar regras

Depois de concluir a definição das suas Regras de Aprovação de Pull Request, você deve salvá-las antes que elas se apliquem a quaisquer Pull Requests novos e ativos.

1. Clique em Salvar.