記事のバージョン: Enterprise Server 2.17
プルリクエストのマージについて
フィーチャブランチにすべてのコミットを保ち、すべてのコミットを単一のコミットにsquashするか、個々のコミットをhead
ブランチからbase
ブランチにリベースすることによって、プルリクエストをマージできます。
使用している GitHub Enterprise Serverインスタンス上のプルリクエストでフォルトのMerge pull request(プルリクエストのマージ)オプションをクリックすると、フィーチャブランチからのすべてのコミットがマージコミット内でベースブランチに追加されます。 プルリクエストは、--no-ff
オプションを使ってマージされます。
プルリクエストをマージするためには、リポジトリの書き込み権限を持っていなければなりません。
プルリクエストのコミットのsquashとマージ
使用している GitHub Enterprise Serverインスタンス上のプルリクエストでSquash and merge(squashとマージ)オプションを選択すると、そのプルリクエストのコミットは1つのコミットにsquashされます。 トピックブランチからコントリビュータの個々のコミットをすべて見る代わりに、コミットは1つのコミットにまとめられ、デフォルトブランチにマージされます。 squashされたコミットを持つプルリクエストは、fast-forwardオプションを使ってマージされます。
プルリクエストをsquashしてマージするには、リポジトリへの書き込み権限を持っていなければならず、リポジトリではsquashマージが許可されていなければなりません。
squashとマージは、よりスムーズなGitの履歴をリポジトリに作り出すために利用できます。 作業途中でのコミットは、フィーチャブランチで作業しているときには役立ちますが、必ずしもGitの履歴に残すほど重要とはかぎりません。 デフォルトブランチへのマージに際してそれらのコミットを1つのコミットにsquashすれば、明快なGitの履歴と共にオリジナルの変更を残しておけます。
プルリクエストコミットのリベースとマージ
使用している GitHub Enterprise Serverインスタンス上のプルリクエストでRebase and merge(リベースとマージ)オプションを選択すると、トピックブランチ(あるいはheadブランチ)のすべてのコミットが、マージコミットなしに個別にベースブランチに追加されます。 リベースされたコミットを持つプルリクエストは、fast-forwardオプションを使ってマージされます。
プルリクエストをリベースしてマージするには、リポジトリへの書き込み権限が必要で、リポジトリではリベースマージが許可されていなければなりません。
GitHub Enterprise上でのリベースとマージの振る舞いは、gitのリベース
とは少し異なっています。 GitHub上でのリベースとマージは、常にコミッターの情報を更新し、新しいSHAを生成しますが、GitHub外でのgit rebase
は祖先のコミット上でリベースが生じたときにコミッター情報を変更しません。 git rebase
に関する詳しい情報については書籍Pro Gitの"Git rebase" の章を参照してください。
git rebase
の視覚的な表現については、書籍Pro Gitの"Git Branching - Rebasing"の章を参照してください。
以下の場合、使用している GitHub Enterprise Serverインスタンス上で自動的にリベースおよびマージすることはできません:
- プルリクエストにマージコンフリクトがある。
- ベースブランチからヘッドブランチへのコミットのリベースでコンフリクトが生じる。
- たとえば、マージコンフリクトなしにリベースできるものの、マージとは異なる結果が生成されるような場合、コミットのリベースは「安全ではない」と考えられます。
それでもコミットをリベースしたいにもかかわらず、使用している GitHub Enterprise Serverインスタンス 上で自動的にリベースとマージが行えない場合、以下のようにしなければなりません:
- トピックブランチ (あるいは head ブランチ) をベースブランチにローカルでコマンドラインからリベースする
- コマンドライン上でマージコンフリクトを解決する
- リベースされたコミットをプルリクエストのトピックブランチ (あるいはリモートの head ブランチ) にフォースプッシュする。
リポジトリに書き込み権限を持つ人は、続いて使用している GitHub Enterprise Serverインスタンス上のリベース及びマージボタンを使って変更をマージできます。