リポジトリのブランチ

ブランチを使用すると、メインのコードベースに影響を与えずに新しい機能の作業に取り組めます。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. Click the Source page of your repository. You should see both the main branch and the <feature> branch in the branches dropdown. When you make commits to the feature branch, you'll see the files specific to that branch.

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

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

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. View the Source page of your repository in Bitbucket. You should see both the main and the feature branch. When you select the feature branch, you see the Source page from that perspective. Select the feature branch to view its Recent commits.

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

To create branches in Jira it must be connected with Bitbucket.

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

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

3. Select the Branch type and Branch name, then click Create branch. Bitbucket may suggest a Branch type based on the Jira issue type, when the branching model is configured. 

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

ブランチ モデル

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

ブランチ タイプ

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

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

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

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

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

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

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

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

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

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

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

ブランチをクローズする

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

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

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

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

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

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

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

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

ブランチの一括削除

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

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

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

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

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