リポジトリのブランチ

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

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

ブランチの作成

Git および Mercurial リポジトリでブランチを作成できます。Git ブランチには常に名前がありますが、Mercurial にはブランチと名前付きブランチの概念があります。詳細については、スティーブ・ロッシュのガイドをご覧ください。このドキュメントでは、2 つのシステムでのブランチについてわかりやすく説明されています。

Git ブランチの作成

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

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

  1. リポジトリのグローバル サイドバーで + をクリックして、[作業に取りかかりましょう] の下の [ブランチの作成] を選択します
  2. 表示されたポップアップから、[タイプ] (ブランチ モデルを使用している場合) を選択し、ブランチ名を入力して、[作成] をクリックします。
  3. ブランチを作成したら、ローカル システムからブランチをチェックアウトする必要があります。Bitbucket では、次のコマンドに似たフェッチおよびチェックアウト コマンドを使用できます。

    $ git fetch && git checkout <feature>
  4. Make your changes locally and then add, commit, and push your changes to the <feature> branch:

    $ git add .
    $ git commit -m "adding a change from the feature branch"
    $ git push origin <feature>
  5. Click the Source page of your repository. You should see both the master 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
    * master

    This output indicates there is a single branch, the master and the asterisk indicates it is currently active.

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

    $ git branch <feature_branch>
  3. 作業するためにフィーチャー ブランチに切り替えます。

    $ git checkout <feature_branch>

    You can list the branches again with the git branch command.

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

    $ git add .
    $ git commit -m "adding a change from the feature branch"
  5. Switch back to the master branch.

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

    $ git push origin <feature_branch>
  7. View the Source page of your repository in Bitbucket. You should see both the master 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.

Mercurial ブランチの作成

Mercurial ブランチを作成する場合、ローカルで作成するか、Jira Software から作成することができます。

  1. リポジトリで新しい機能ブランチを作成します。

    $ hg branch <feature_branch>

    Nothing changes in the working directory. The branch command tells Mercurial the branch name to use with your next commit. If you use the hg branches command, you'll see you still only have the default branch.

  2. 作業用のコピーでファイルの編集、ファイルの追加、およびコミットを行います。

  3. 変更をコミットします。
  4. Run the hg branches command again.

    $ hg branches
    feature                     3159:6ab9a159fc43
    default                     3158:5b8b05432593 (inactive)
  5. Push the feature branch back to Bitbucket. To do so, you'll need to do a force push with hg push -f.

    $ hg push --force

Jira Software の課題からブランチを作成する方法

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

  1. [開発] パネルで、[ブランチを作成] をクリックします。Bitbucket のブランチ作成画面が表示されます。
    Development の先頭でのブランチの作成を示す画像
  2. ブランチの作成先となるリポジトリを選択します。
  3. [ブランチ タイプ] および [ブランチ名] を選択し、[ブランチを作成] をクリックします。ブランチ モデルが設定されている場合、Bitbucket が Jira Software の課題タイプに基づいてブランチ タイプを提案する場合があります。 

    See how the branching models and issue types are mapped...
    Jira Software 課題タイプ Bitbucket ブランチ タイプ
    バグ

    Bugfix

    (Feature if Bugfix type is not enabled)

    ストーリー 機能
    その他 その他 / カスタム



    新しいブランチ タイプ ドロップダウンを示す画像

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

ブランチ モデル

You can use the branching model to define a branch based workflow for your repositories. When you map your workflow to branch types, you can ensure that branches are named consistently by configuring which branch types to make available. We've suggested some branch prefixes you might want to use but you can also specify your own naming convention. A consistent naming convention makes it easier to identify branches by type. You can also define which branches are your development and production branches, which allows us to better suggest source and target branches for creation and pull requests.

Branch types

There are several types of branches that are frequently used in software development. This section explains what each branch type is for, and the typical prefix convention for each branch type. In Bitbucket, the prefix can be changed for all branches other than development or production.


  Development branch

Usually the integration branch for feature work and is often the default branch or a named branch. For pull request workflows, the branch where new feature branches are targeted.

master
or
develop

  Production branch

Used for deploying a release. Branches from, and merges back into, the development branch. In a Gitflow-based workflow it is used to prepare for a new production release. 

varies

 Feature branch

特定の機能の作業または改善に使用されます。一般に、プル リクエストを使用して、開発ブランチから分岐し、開発ブランチにマージされます。

feature/

  Release branch

リリース タスクや長期的なメンテナンス バージョンに使用されます。開発ブランチから分岐し、開発ブランチにマージされます。

release/

 Bugfix branch

Typically used to fix Release branches.

bugfix/

 Hotfix branch

Used to quickly fix a Production branch without interrupting changes in the development branch. In a Gitflow-based workflow, changes are usually merged into the production and development branches.

hotfix/

Configure a repository's branching model

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

  1. [リポジトリ設定] に移動します。
  2. [ワークフロー] で [ブランチ モデル] を選択します。
  3. リポジトリ ブランチ モデルの詳細を選択し、[保存] をクリックします。

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

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

  1. [コミット] ページに移動します。
  2. [すべてのブランチ] がまだ選択されていない場合は、[すべてを表示] を選択します。
    右側にコメントとブランチ タグのリストが、左側にはグラフが表示されます。
    ブランチとの関係を示すコミットの画像
  3. コミット タグのリンクをクリックすると、コンテンツの詳細を表示できます。

ブランチをクローズする

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

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

  • リポジトリの [ブランチ] ページから、右側のオプション リンクにカーソルを合わせて [ブランチの削除] を選択します。
    ドロップダウンの最後のオプションを使用してブランチを削除している画像
  • ブランチでプル リクエストを作成する際に、[ブランチのクローズ] チェックボックスを選択します。これは、プル リクエストがマージされるとブランチをクローズするものです。
    プル リクエスト ダイアログ ボックスの画像
最終更新日 2019 年 3 月 6 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.