2017-09-10 17:25:29 +05:30
|
|
|
# Branches
|
|
|
|
|
|
2018-03-17 18:26:18 +05:30
|
|
|
Read through GiLab's branching documentation:
|
|
|
|
|
|
2019-03-02 22:35:43 +05:30
|
|
|
- [Create a branch](../web_editor.md#create-a-new-branch).
|
|
|
|
|
- [Default branch](#default-branch).
|
|
|
|
|
- [Protected branches](../../protected_branches.md#protected-branches).
|
|
|
|
|
- [Delete merged branches](#delete-merged-branches).
|
|
|
|
|
- [Branch filter search box](#branch-filter-search-box).
|
2018-03-17 18:26:18 +05:30
|
|
|
|
|
|
|
|
See also:
|
|
|
|
|
|
2019-03-02 22:35:43 +05:30
|
|
|
- [Branches API](../../../../api/branches.md), for information on operating on repository branches using the GitLab API.
|
2019-07-07 11:18:12 +05:30
|
|
|
- [GitLab Flow](../../../../university/training/gitlab_flow.md). Use the best of GitLab for your branching strategies.
|
2019-03-02 22:35:43 +05:30
|
|
|
- [Getting started with Git](../../../../topics/git/index.md) and GitLab.
|
2018-03-17 18:26:18 +05:30
|
|
|
|
|
|
|
|
## Default branch
|
|
|
|
|
|
|
|
|
|
When you create a new [project](../../index.md), GitLab sets `master` as the default
|
|
|
|
|
branch for your project. You can choose another branch to be your project's
|
2018-11-20 20:47:30 +05:30
|
|
|
default under your project's **Settings > Repository**.
|
2018-03-17 18:26:18 +05:30
|
|
|
|
|
|
|
|
The default branch is the branch affected by the
|
2019-09-30 21:07:59 +05:30
|
|
|
[issue closing pattern](../../issues/managing_issues.md#closing-issues-automatically),
|
2018-03-17 18:26:18 +05:30
|
|
|
which means that _an issue will be closed when a merge request is merged to
|
|
|
|
|
the **default branch**_.
|
|
|
|
|
|
|
|
|
|
The default branch is also protected against accidental deletion. Read through
|
|
|
|
|
the documentation on [protected branches](../../protected_branches.md#protected-branches)
|
|
|
|
|
to learn more.
|
|
|
|
|
|
2017-09-10 17:25:29 +05:30
|
|
|
## Delete merged branches
|
|
|
|
|
|
2018-12-13 13:39:08 +05:30
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/6449) in GitLab 8.14.
|
2017-09-10 17:25:29 +05:30
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This feature allows merged branches to be deleted in bulk. Only branches that
|
2018-12-13 13:39:08 +05:30
|
|
|
have been merged and [are not protected](../../protected_branches.md) will be deleted as part of
|
2017-09-10 17:25:29 +05:30
|
|
|
this operation.
|
|
|
|
|
|
2018-03-17 18:26:18 +05:30
|
|
|
It's particularly useful to clean up old branches that were not deleted
|
2017-09-10 17:25:29 +05:30
|
|
|
automatically when a merge request was merged.
|
|
|
|
|
|
2018-12-13 13:39:08 +05:30
|
|
|
## Branch filter search box
|
|
|
|
|
|
|
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22166) in GitLab 11.5.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This feature allows you to search and select branches quickly. Search results appear in the following order:
|
|
|
|
|
|
|
|
|
|
- Branches with names that matched search terms exactly.
|
|
|
|
|
- Other branches with names that include search terms, sorted alphabetically.
|
|
|
|
|
|
|
|
|
|
Sometimes when you have hundreds of branches you may want a more flexible matching pattern. In such cases you can use the following:
|
|
|
|
|
|
|
|
|
|
- `^feature` will only match branch names that begin with 'feature'.
|
|
|
|
|
- `feature$` will only match branch names that end with 'feature'.
|
