リポジトリのブランチ

ブランチを使用すると、メインのコードベースに影響を与えずに新しい機能の作業に取り組めます。Bitbucket、Jira、またはターミナルからブランチを作成できます。変更を行ったあと、そのブランチを Bitbucket にプッシュすることで、プル リクエストでのレビューを依頼できます。

ブランチの作成

Git ブランチを作成するには、Bitbucket で作成する方法、ローカルのコマンド ラインで作成する方法、Jira で作成する方法の 3 通りがあります。

Bitbucket からブランチを作成する方法

1. リポジトリから [作成] ボタンを選択します。

2. ドロップダウン メニューから [ブランチ] を選択します。

3. 表示されたポップアップから、[タイプ] (ブランチ モデルを使用している場合) を選択し、ブランチ名を入力して、[作成] をクリックします。

   注: Bitbucket または Jira の課題からブランチを作成するたびに、Bitbucket は参照、ファイル システム、またはシェルから無効な文字を削除して、有効な代替文字に置き換えます。

4. ブランチを作成したら、ローカル システムからブランチをチェックアウトする必要があります。Bitbucket では、次のコマンドに似たフェッチおよびチェックアウト コマンドを使用できます。

   $ git fetch && git checkout <feature>

5. ローカル側で変更を行ってから、その変更を追加およびコミットし、<feature> ブランチにプッシュします。

   $ git add .
$ git commit -m "adding a change from the feature branch"
$ git push origin <feature>

6. リポジトリの [ソース] ページをクリックします。ブランチのドロップダウンに main ブランチと <feature> ブランチの両方が表示されます。フィーチャー ブランチにコミットを行うと、そのブランチに固有のファイルが表示されます。

ローカルでブランチを作成する方法

リポジトリのクローン バージョンがある場合、ローカルでブランチを作成できます。

1. ターミナル ウィンドウから、リポジトリのブランチを一覧表示します。

   $ git branch

2. リポジトリで新しいフィーチャー ブランチを作成します。

   $ git branch <feature_branch>

3. 作業するためにフィーチャー ブランチに切り替えます。

   $ git checkout <feature_branch>

   git branch コマンドを使用して、再びブランチを一覧表示します。

4. 新しいフィーチャー ブランチへの変更をコミットします。

   $ git add .
$ git commit -m "adding a change from the feature branch"

5. main ブランチに切り替えます。

   $ git checkout main

6. フィーチャー ブランチを Bitbucket にプッシュします。

   $ git push origin <feature_branch>

7. Bitbucket でリポジトリの [ソース] ページを表示します。main ブランチとフィーチャー ブランチの両方が表示されます。フィーチャー ブランチを選択すると、対応した [ソース] ページが表示されます。フィーチャー ブランチを選択して、そのブランチの最近のコミットを表示します。

Jira で課題からブランチを作成するには、次の手順に従います。

Jira でブランチを作成するには、Jira が Bitbucket と接続されている必要があります。

1. [開発] パネルで、[ブランチを作成] をクリックします。Bitbucket のブランチ作成画面が表示されます。

2. ブランチの作成先となるリポジトリを選択します。

3. [ブランチ タイプ] と [ブランチ名] を選択して、[ブランチを作成] をクリックします。ブランチ モデルが設定されている場合は、Bitbucket が Jira の課題タイプに基づいてブランチ タイプを提案する場合があります。 

4. 新しいブランチが作成されると、Bitbucket はファイルの一覧を表示します。これで、ローカル リポジトリへのプルを行い、新しいブランチに切り替えることができます。

ブランチ モデル

ブランチ モデルを使用してリポジトリのブランチ ベース ワークフローを定義できます。ワークフローをブランチ タイプにマッピングすると、管理者は利用可能なブランチ タイプを設定して、ブランチ名の一貫性を確保することができます。ブランチのプリフィックス案が表示されますが、独自の命名規則を指定することもできます。一貫した命名規則があると、ブランチをタイプごとに簡単に識別することができます。また、開発および本番ブランチを定義することもできます。これにより、作成やプル リクエスト時のソースやターゲット ブランチの推奨精度を改善することができます。

ブランチ タイプ

ソフトウェア開発では、複数のブランチ タイプがよく使用されます。このセクションでは、各ブランチ タイプの用途と、各ブランチ タイプのプリフィックスに関する一般的な規則について説明します。Bitbucket では、プリフィックスは開発または本番以外のすべてのブランチ用に変更できます。

リポジトリのブランチ モデルの構成

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

1. [リポジトリ設定] に移動します。

2. [ワークフロー] で [ブランチ モデル] を選択します。

3. リポジトリ ブランチ モデルの詳細を選択し、[保存] をクリックします。

ブランチでコミットを一覧表示する

Bitbucket はブランチ別にコミットのリストを保持します。リストでは、main ブランチより先の保留中のコミットがあるオープンなブランチのみを示します。特定のブランチに関連付けられているコミットを表示するには、リポジトリを表示して次の手順に従います。

1. [コミット] ページに移動します。

2. [すべてのブランチ] がまだ選択されていない場合は、[すべてを表示] を選択します。

3. コミット タグのリンクをクリックすると、コンテンツの詳細を表示できます。

ブランチをクローズする

リポジトリのブランチを定期的に取り除くことが重要です。ブランチをクローズすると、Bitbucket インターフェイスからブランチが削除されます。ローカル リポジトリ内のブランチには影響しません。これは、Git または Hg の関連コマンドを使用し、必要に応じて削除する必要があります。

ブランチは 2 つの方法でクローズできます。

• リポジトリの [ブランチ] ページから、右側のオプション リンクにカーソルを合わせて [ブランチの削除] を選択します。

• ブランチでプル リクエストを作成する際に、[ブランチのクローズ] チェックボックスを選択します。これは、プル リクエストがマージされるとブランチをクローズするものです。
  

Bitbucket はブランチ別にコミットのリストを保持します。リストでは、main ブランチより先の保留中のコミットがあるオープンなブランチのみを示します。特定のブランチに関連付けられているコミットを表示するには、リポジトリを表示して次の手順に従います。

1. [コミット] ページに移動します。

2. [すべてのブランチ] がまだ選択されていない場合は、[すべてを表示] を選択します。

3. コミット タグのリンクをクリックすると、コンテンツの詳細を表示できます。

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

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 repository (requires repository admin permission):

1. Go to the repository where you want to set the default for branch deletion on merge.

2. Select Repository settings on the left sidebar.

3. Select Branching model on the left sidebar under Workflow.

4. Under Delete source branch by default, 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 project (requires project admin permission):

1. Go to the project where you want to set the default for branch deletion on merge.

2. Select Project settings on the left sidebar.

3. Select Branching model on the left sidebar under Workflow.

4. Under Delete source branch by default, 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.

ブランチの一括削除

次の手順に従って、ブランチを一括削除できます。

1. リポジトリで、左側のサイドバーの [ブランチ] を選択します。

2. (…) > [Delete multiple (複数削除)] をクリックします。

3. 削除するブランチをチェックし、[Delete selected branches (選択したブランチの削除)] をクリックします。

4. 選択内容を確認します。