2016-09-29 09:46:39 +05:30
|
|
|
# Automatic issue closing
|
|
|
|
|
2018-03-17 18:26:18 +05:30
|
|
|
>**Notes:**
|
2019-07-07 11:18:12 +05:30
|
|
|
>
|
2018-03-17 18:26:18 +05:30
|
|
|
> - This is the user docs. In order to change the default issue closing pattern,
|
|
|
|
> follow the steps in the [administration docs].
|
|
|
|
> - For performance reasons, automatic issue closing is disabled for the very
|
|
|
|
> first push from an existing repository.
|
2016-09-29 09:46:39 +05:30
|
|
|
|
|
|
|
When a commit or merge request resolves one or more issues, it is possible to
|
|
|
|
automatically have these issues closed when the commit or merge request lands
|
|
|
|
in the project's default branch.
|
|
|
|
|
|
|
|
If a commit message or merge request description contains a sentence matching
|
|
|
|
a certain regular expression, all issues referenced from the matched text will
|
2018-03-17 18:26:18 +05:30
|
|
|
be closed. This happens when the commit is pushed to a project's
|
|
|
|
[**default** branch](../repository/branches/index.md#default-branch), or when a
|
|
|
|
commit or merge request is merged into it.
|
2016-09-29 09:46:39 +05:30
|
|
|
|
|
|
|
## Default closing pattern value
|
|
|
|
|
|
|
|
When not specified, the default issue closing pattern as shown below will be
|
|
|
|
used:
|
|
|
|
|
|
|
|
```bash
|
2018-03-17 18:26:18 +05:30
|
|
|
((?:[Cc]los(?:e[sd]?|ing)|[Ff]ix(?:e[sd]|ing)?|[Rr]esolv(?:e[sd]?|ing)|[Ii]mplement(?:s|ed|ing)?)(:?) +(?:(?:issues? +)?%{issue_ref}(?:(?:, *| +and +)?)|([A-Z][A-Z0-9_]+-\d+))+)
|
2016-09-29 09:46:39 +05:30
|
|
|
```
|
|
|
|
|
|
|
|
Note that `%{issue_ref}` is a complex regular expression defined inside GitLab's
|
2018-11-20 20:47:30 +05:30
|
|
|
source code that can match references to:
|
2019-02-15 15:39:39 +05:30
|
|
|
|
|
|
|
- A local issue (`#123`).
|
|
|
|
- A cross-project issue (`group/project#123`).
|
|
|
|
- A link to an issue
|
|
|
|
(`https://gitlab.example.com/group/project/issues/123`).
|
2016-09-29 09:46:39 +05:30
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
This translates to the following keywords:
|
|
|
|
|
|
|
|
- Close, Closes, Closed, Closing, close, closes, closed, closing
|
|
|
|
- Fix, Fixes, Fixed, Fixing, fix, fixes, fixed, fixing
|
|
|
|
- Resolve, Resolves, Resolved, Resolving, resolve, resolves, resolved, resolving
|
2018-03-17 18:26:18 +05:30
|
|
|
- Implement, Implements, Implemented, Implementing, implement, implements, implemented, implementing
|
2016-09-29 09:46:39 +05:30
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
For example the following commit message:
|
|
|
|
|
|
|
|
```
|
|
|
|
Awesome commit message
|
|
|
|
|
|
|
|
Fix #20, Fixes #21 and Closes group/otherproject#22.
|
|
|
|
This commit is also related to #17 and fixes #18, #19
|
|
|
|
and https://gitlab.example.com/group/otherproject/issues/23.
|
|
|
|
```
|
|
|
|
|
|
|
|
will close `#18`, `#19`, `#20`, and `#21` in the project this commit is pushed
|
|
|
|
to, as well as `#22` and `#23` in group/otherproject. `#17` won't be closed as
|
|
|
|
it does not match the pattern. It works with multi-line commit messages as well
|
|
|
|
as one-liners when used with `git commit -m`.
|
|
|
|
|
|
|
|
[administration docs]: ../../../administration/issue_closing_pattern.md
|