ブランチについて

ブランチについて

ブランチを使用すると、リポジトリ内の領域で機能を開発したり、バグを修正したり、新しいアイデアを安全に試したりすることができます。

ブランチは常に既存のものから作成します。 通常、リポジトリのデフォルトブランチから新しいブランチを作成します。 その後、他の人がリポジトリに加えた変更とは別に、新しいブランチで作業できます。 機能を構築するために作成するブランチは、通常、フィーチャブランチまたはトピックブランチと呼ばれます。 詳しい情報についてはリポジトリ内でのブランチの作成と削除を参照してください。

また、GitHub Pagesサイトを公開するためにブランチを使うこともできます。 詳しい情報については「GitHub Pagesについて」を参照してください。

ブランチの作成、プルリクエストのオープン、プルリクエスト中でのブランチの削除とリストアを行うためには、リポジトリへの書き込みアクセスを持っていなければなりません。 詳細は「GitHub 上のアクセス権限」を参照してください。

About the default branch

When you create a repository with content on your GitHub Enterprise Server instance, GitHub Enterprise Server creates the repository with a single branch. This first branch in the repository is the default branch. デフォルトブランチは、誰かがあなたのリポジトリにアクセスしたときに GitHub が表示されるブランチです。 また、デフォルトブランチは、誰かがリポジトリのクローンを作成したときに Git がローカルでチェックアウトする最初のブランチでもあります。 Unless you specify a different branch, the default branch in a repository is the base branch for new pull requests and code commits.

デフォルトでは、GitHub Enterprise Server は新しいリポジトリのデフォルトブランチ master に名前を付けます。

You can set the name of the default branch for new repositories. For more information, see "Managing the default branch for your repositories," "Managing the default branch name for repositories in your organization," and "Enforcing repository management policies in your enterprise."

ブランチを使用する

満足の行くところまで作業したら、プルリクエストをオープンして、現在のブランチ（head ブランチ）の変更を別のブランチ（base ブランチ）にマージできます。 詳しい情報についてはプルリクエストについてを参照してください。

プルリクエストがマージまたはクローズされた後、head ブランチは不要になり削除できます。 ブランチを削除するには、リポジトリへの書き込みアクセスが必要です。 オープンなプルリクエストに直接関連付けられているブランチは削除できません。 詳しい情報については「プルリクエスト中のブランチの削除と復元」を参照してください。

保護されたブランチでの作業

リポジトリ管理者は、ブランチの保護を有効化できます。 保護されたブランチで作業しているなら、ブランチを削除したり、ブランチにフォースプッシュしたりすることはできません。 リポジトリ管理者は、保護されたブランチの他の設定を有効化し、ブランチがマージできるようになる前に様々なワークフローを適用できます。

プルリクエストがマージできるかを調べるには、プルリクエストの Conversation（会話）タブの下部にあるマージボックスを見てください。 詳しい情報については保護されたブランチについてを参照してください。

ブランチが保護されていると、以下のようになります。

• ブランチの削除やブランチへのフォースプッシュはできません。
• ブランチでステータスチェック必須が有効化されていると、必要なCIテストがすべてパスするまで、変更をブランチにマージできません。 詳しい情報についてはステータスチェックについてを参照してください。
• ブランチでプルリクエストレビュー必須が有効化されている場合、プルリクエストレビューポリシー中のすべての要求が満たされるまでは、ブランチに変更をマージできません。 詳しい情報についてはプルリクエストのマージを参照してください。
• ブランチでコードオーナーからの必須レビューが有効化されており、プルリクエストがオーナーを持つコードを変更している場合、コードオーナーがプルリクエストを承認しなければ、そのプルリクエストはマージできません。 詳細は「コードオーナーについて」を参照してください。
• ブランチでコミット署名必須が有効化されている場合、署名および検証されていないコミットはブランチにプッシュできません。 For more information, see "About commit signature verification" and "About protected branches."

参考リンク

• プルリクエストについて
• GitHub 用語集中のブランチ
• Gitのドキュメンテーション中のブランチの要約