> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-pt-br/configuracoes/configuracoes-de-pull-requests/adicionando-regras-de-aprovacao-de-pull-requests.md).

# Adicionando regras de aprovação de pull requests

{% hint style="warning" %}

#### 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](/devops/devops-pt-br/transicao-para-a-nova-ui-ux/para-onde-foi.md) artigo.
{% endhint %}

## ![](https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) 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-*`).

{% hint style="info" %}
**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**.
  {% endhint %}

### Exemplo de Pull Request

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

<div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2Fgva6lxevix2yaZlMoEcy%2FAddingPullRequestApprovalRules-ExamplePR-01.png?alt=media&amp;token=c7d02afa-6428-4c8c-bb3d-bc882c01f5d4" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FI0ZH1rlNYGgphPVQA0Nn%2FAddingPullRequestApprovalRules-Hierarchy-01.png?alt=media&amp;token=eaf0c582-6a4b-4ebe-912b-974fabfca82f" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
**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.
{% endhint %}

## Adicionando Regras de Aprovação

{% stepper %}
{% step %}

### 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**.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FY3jWoGiTJytNyrNSx60t%2FAddingPullRequestApprovalRules-S01-01.png?alt=media&amp;token=ef6088d4-4f97-46f1-b3b4-30830bc5cb22" alt="" width="563"><figcaption></figcaption></figure></div>
4. Se estiver desativado, clique na **Ativar** chave para ativar as regras de aprovação.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FT2Tj9CODPAbKO35961tZ%2FAddingPullRequestApprovalRules-S01-02.png?alt=media&amp;token=9d65fe33-321e-4a18-865e-b06db10fc69c" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Selecionar Branches

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

<div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FbR9hPT2MwPyiv0yshfvS%2FAddingPullRequestApprovalRules-S02-01.png?alt=media&amp;token=34734bf6-a1ab-4746-b14b-2be32088fb4c" alt="" width="563"><figcaption></figcaption></figure></div>

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

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FVHxHzNSV4P3xFXYy0hdp%2FAddingPullRequestApprovalRules-S02-02.png?alt=media&amp;token=99b0bcad-7176-44fc-ad15-d49dc94b8f2e" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
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.
{% endhint %}

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

<table><thead><tr><th width="260.3333740234375">Ramificações</th><th>Regra aplicada</th></tr></thead><tbody><tr><td>main</td><td><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FzwOFIIvK4ue9gjxBh5iX%2FX-Icon.svg?alt=media&amp;token=bbcd7bc0-1097-450d-b6ce-62677c4c4097" alt="" data-size="line"></td></tr><tr><td>feature/addAccount</td><td><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FFyAlTI4AIHg46Nb6SL90%2FCheckBox-Icon.svg?alt=media&amp;token=3ab847f7-5568-405e-aa0a-23e02f38d451" alt="" data-size="line"></td></tr><tr><td>feature/removeAccount</td><td><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FFyAlTI4AIHg46Nb6SL90%2FCheckBox-Icon.svg?alt=media&amp;token=3ab847f7-5568-405e-aa0a-23e02f38d451" alt="" data-size="line"></td></tr><tr><td>release/v1.2.3</td><td><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FzwOFIIvK4ue9gjxBh5iX%2FX-Icon.svg?alt=media&amp;token=bbcd7bc0-1097-450d-b6ce-62677c4c4097" alt="" data-size="line"></td></tr></tbody></table>

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

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FMqLrxpAMXQQzEBLi3SAB%2FAddingPullRequestApprovalRules-S02-03.png?alt=media&amp;token=1f6bc647-7fac-48f7-893a-e1f0e9615228" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

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

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FwG4OjnQowOSVUuOCWmJA%2FAddingPullRequestApprovalRules-S03-01.png?alt=media&amp;token=b91a5f76-2554-4332-a9c1-892b554bcd53" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 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**.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FdtekyIgb3Cazd7B5S3x2%2FAddingPullRequestApprovalRules-S04-01.png?alt=media&amp;token=38a05ed8-1741-4814-917f-eaece9dfe84b" alt="" width="563"><figcaption></figcaption></figure></div>
2. Configure a seleção de branches e a contagem de aprovações da regra usando as instruções acima.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEQJi4R9BHx7qNLRqqugx%2FAddingPullRequestApprovalRules-S04-02.png?alt=media&amp;token=8ffa3e68-0159-48d6-88a6-fac98165c3ef" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 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**.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FdZ71ysJBzoNJTYOQXhgf%2FAddingPullRequestApprovalRules-S05-01.png?alt=media&amp;token=77185241-534e-453b-9151-f97cff105039" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/devops/devops-pt-br/configuracoes/configuracoes-de-pull-requests/adicionando-regras-de-aprovacao-de-pull-requests.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
