doc/workflow/merge_request_approvals.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

# Merge Request Approvals

If you want to make sure every merge request is approved by one or more
people, you can enforce this workflow by using merge request approvals.
Merge request approvals allow you to set the number of necessary approvals
and predefine a list of approvers that will need to approve every
merge request in a project.

![Merge request approval](merge_request_approvals/2_approvals.png)

## Configuring Approvals

You can configure the approvals in the project settings, under merge requests.

![Merge Request Approvals in Project Settings](merge_request_approvals/approvals_settings.png)

To enable it, set **Approvals required** to 1 or higher.

### Approvals Required

This sets the amount of approvals required before being able to merge a merge request.
At 0, this disables the feature. Any value above requires that amount of different
users to approve the merge request.

### Reset approvals on push

With this setting turned on, approvals are reset when a new push
is done to the merge request branch.

Turn "Reset approvals on push" off if you want approvals to persist,
independent of changes to the merge request.

### Approvers

At approvers you can define the default set of users that need to approve a
merge request.

If there are more approvers than required approvals, any subset of these users
can approve the merge request.

If there are less approvers than required approvals, all the set approvers plus
any other user(s) need to approve the merge request before being able to merge it.

![One specific user and someone else need to approve this merge request](merge_request_approvals/1_named_approval.png)

If the approvers are equal to the amount of required approvals, all the approvers are
required to approve merge requests.

![Two specific users need to approve this merge request](merge_request_approvals/2_named_approvals.png)

Note that approvers can be changed during merge request creation.

## Using Approvals

After configuring Approvals, you will see the following during merge request creation.

![Choosing approvers in merge request creation](merge_request_approvals/approvals_mr.png)

You can change the default set of approvers before creating the merge request.
You can't change the amount of required approvals. This ensures that you're
not forced to adjust settings when someone is unavailable for approval, yet
the process is still enforced.

To approve a merge request, simply press the button.

![Merge request approval](merge_request_approvals/2_approvals.png)