Bitbucket Data Center and Server makes it easy to use a branching workflow for your Git development process. This page describes how to use to use branches with Bitbucket.

On this page:

関連ページ

• Using branch permissions
• Automatic branch merging
• Branch permission patterns

ブランチの作成

You can create a new branch from within JIRA Software or in Bitbucket. Bitbucket suggests the Branch type and Branch name based on where you are creating the branch from in the application. You can change these values depending on your branching model.

When creating a branch, you will provide this information for each branch:

• the Repository
• the Branch type, if a branching model has been previously configured – choose Custom if you need an ad hoc branch type
• the Branch from point – you can choose either a branch or a tag.
• the Branch name – the prefix is based on the branch type you selected, and as defined by the branching model. 

Create a branch from JIRA Software

To create a branch when viewing an issue in JIRA Software:

 ^{Must have JIRA Software version 6.1 or above, and it must be connected with Bitbucket by an application link.}

1. In the Development pane, click Create Branch (requires the View Development Tools project permission).
   
   
2. Choose the SCM, if more than one is available, where you want to create the branch.

3. Select the Branch type and Branch name, then click Create branch. Bitbucket suggests a Branch type based on the JIRA Software issue type, when a branching model is configured. 

   See how the branching models and issue types are mapped...

   JIRA Software issue type	Bitbucket branch type
   バグ	Bugfix
   ストーリー	機能
   新機能	機能

   
   
   

4. Once the new branch is created, Bitbucket takes you to the file listing for that. You can now pull to your local repository and switch to the new branch.

Create a branch from Bitbucket

ブランチを作成するには:

1. In Bitbucket, choose Create branch from the sidebar.
2. Select the Branch type and Branch name. 
   
   
3. Click Create branch. Once the new branch is created, Bitbucket takes you to the file listing for that. You can now pull to your local repository and switch to the new branch.

---

Configure branching models

With Bitbucket you can use branching models to define a branch workflow for repositories. When you map your workflow to repository branches with a branching model, admins can guide developers to name branches consistently by configuring which branch types to make available. There are a number of branch types available, and several branch types have default branch naming prefixes (described below). You can also specify your own naming convention for each branch type. A consistent naming convention makes it easier to identify branches by type.

Branch types

Bitbucket comes with several types of branches that are frequently used in software development. This section explains what each branch type is for, and has the typical naming convention for the prefix for each branch type. The prefix can be changed for each branch type.

You can configure a branching model for either:

• a whole project, so that repositories within a project can inherit the same branching model, or
• an individual repository, to override a project's branching model.

Configure a project's branching model

参考情報

• New repositories will have the branching model enabled by default, and use the default branch prefixes.

• Enabled branch types can't have empty prefixes, have a 30 character limit, and can't overlap (for example PROD and PRODUCT would overlap).

To configure a branching model for a project (requires project admin permission):

1. Go to Project settings > Branches.
2. Choose the details of branching model for repositories that inherit the project settings, then select Save.

Configure a repository's branching model

リポジトリのブランチ モデルを設定する方法は、次のとおりです (リポジトリ管理者権限が必要)。

1. Go to Repository settings > Branches.
2. Under Project settings inheritance, select Use custom settings.
3. Choose the details of your repository branching model, then select Save.

---

Automate the branch workflow

Bitbucket can automate some merges in the branch workflow, based on the branching model for the repository. This allows merges to be cascaded to newer branches of the same parent, subject to a few conditions, so reducing the need for manual maintenance of branches.

To enable automatic merge for a project or repository (requires repo/project admin permissions):

1. Go to Settings > Branches for a project or repository.
2. Under Automatic merging, select the On status and then select Save.

If Bitbucket cannot perform an automatic merge, perhaps because of a conflict, it creates a new pull request for that merge, and the automatic merge operation stops. You should then resolve the conflict locally before approving the new pull request, which may involve further cascading merges.

See Automatic branch merging for more information about the conditions for automatic merging, and how Bitbucket determines the ordering of branches.

---

Find and manage branches

The branch listing page makes it easy to keep track of all the branches in your repository, to get there just select Branches from the side navigation bar. 

The branch listing allows you to:

• See how many commits behind or ahead your branch is compared to a chosen 'base branch'.
• See the latest status for pull requests originating from branches.
• See the build status of branches at a glance.

• Track the review and merge work that still needs to be done and can help with branch cleanup.
• Identify work in progress as well as stale branches. It is calculated for each branch against the base branch.

^{* Only if you have an integrated build server.}

Search for branches

You can easily find branches by using the search at the top of the table on the Branches screen. If you're using a branching model, you can filter by branch type simply by searching for the prefix – for example, search for "feature/" to see all your feature branches.

You can find the feature and bugfix branches that haven't yet been merged into a particular release (for example, "release/2.10") by changing the 'base branch' – just use the branch selector to change the base branch, and refer to the Behind/Ahead and Pull requests columns.

Branch deletion when merging a pull request

When you merge a pull request, you can choose to delete the source branch after merging is complete. Project and repository admins can set the default behavior to either On (the branch will be deleted after merge) or Off (the branch will not be deleted after merge). Users can override this setting when they merge a pull request.

Set the default for branch deletion on merge

Branch deletion on merge is set to Off by default, therefore the option to delete the branch in the Merge pull request dialog will not be selected.

To change the default status of deleting a source branch on merge for a project (requires project admin permission):

1. Go to Project settings > Branches.
2. Under Branch deletion on merge, select one of the following options:
   • Off - When merging a pull request, the option to delete a source branch will not be selected.
   • On - When merging a pull request, the option to delete a source branch will be selected.

To change the default status of deleting a source branch on merge for a repository (requires repository admin permission):

1. Go to Repository settings > Branches.
2. Under Project settings inheritance, select Custom settings.
3. Under Branch deletion on merge, select one of the following options:
   • Off - When merging a pull request, the option to delete a source branch will not be selected.
   • On - When merging a pull request, the option to delete a source branch will be selected.