Git Flowでnon-fast-forwardでマージする

Git FlowにおけるFeatureブランチのnon-fast-forwardマージ戦略: SourceTreeでの設定と実践

I. はじめに

Git Flowは、複雑なプロジェクト管理を効率化するために考案されたブランチ戦略の一つです。master、develop、feature、release、hotfixといった特定の役割を持つブランチを使い分けることで、開発の並行性、リリース管理の安定性、そして機能開発の独立性を高めます。

しかし、featureブランチでの開発が完了し、developブランチへと統合する際のマージ方法によっては、ブランチの履歴が失われたり、後からの追跡が困難になったりすることがあります。特にSourceTreeのようなGUIツールを使用している場合、デフォルトの動作が意図しない結果を招くことも少なくありません。

本記事では、Git Flowにおけるfeatureブランチの統合時にnon-fast-forwardマージを強制することの重要性とその背景を解説します。そして、人気のあるGit GUIクライアントであるSourceTreeを使用している環境で、このnon-fast-forwardマージを確実に実行するための具体的な設定方法と検証手順を詳しくご紹介します。

II. Fast-forwardマージ vs. Non-fast-forwardマージ

Featureブランチをメインブランチ（developなど）にマージする際、Gitには大きく分けて2つのマージ戦略があります。

1. Fast-forwardマージ (FFマージ)

概要:
マージ元となるブランチの変更が、マージ先のブランチの先端から分岐した後にのみ発生している場合、Gitはマージコミットを生成せずに、マージ先のブランチポインタをマージ元のブランチの先端まで進めることができます。これがfast-forwardマージです。

メリット:

• 履歴のシンプルさ: コミットグラフが直線的になり、履歴が見やすくなります。余計なマージコミットが生成されません。

デメリット:

• ブランチ履歴の消失: Featureブランチの存在自体がコミットグラフから消えてしまうため、後からどのコミット群が特定の機能開発のために行われたものなのか、視覚的に追跡が困難になります。
• Revertの困難さ: 特定のFeatureブランチで導入された変更全体をRevertしたい場合、複数のコミットを一つずつ遡って特定する必要があり、手間がかかります。

2. Non-fast-forwardマージ (Non-FFマージ)

概要:
マージ元のブランチにマージコミットを強制的に生成させるマージ方法です。たとえfast-forward可能な状況であっても、新しいマージコミットが作成されます。

メリット:

• Featureブランチ履歴の保持: マージコミットがFeatureブランチの開始点と終了点を示すため、コミットグラフ上でFeatureブランチの存在が明確に残ります。これにより、どのコミットがどの機能開発に属していたかが一目瞭然になります。
• Revertの容易さ: Featureブランチ全体をRevertしたい場合、そのFeatureブランチがマージされたマージコミット一つをRevertするだけで、Featureブランチで導入された全ての変更を取り消すことができます。
• 明確な統合ポイント: Featureブランチがメインブランチに統合された「時点」が明確に記録されます。

デメリット:

• 履歴の複雑化: マージコミットが頻繁に生成されるため、コミットグラフが分岐と結合を繰り返す形となり、fast-forwardマージに比べて見た目が複雑になることがあります。

Git FlowにおけるFeatureブランチのマージ戦略

Git Flowの文脈では、Featureブランチの履歴を保持し、後からの追跡やRevertを容易にするため、一般的にnon-fast-forwardマージが強く推奨されます。これにより、機能開発の単位をコミットグラフ上で明確に視覚化できます。

III. SourceTreeにおけるデフォルトの動作

多くのGitクライアントと同様に、SourceTreeもGit Flowにおけるfeatureブランチの「完了」処理において、デフォルトではfast-forward可能な場合はfast-forwardマージを実行します。これは、Gitの一般的な動作に従っているためです。

しかし、Gitの設定には「non-fast-forwardマージを行わない場合でも新しいコミットを作成する」といったオプションが存在するにもかかわらず、SourceTreeのGit Flow完了時にはこの設定が期待通りに機能せず、fast-forwardマージが行われてしまうケースが報告されています。これは、SourceTreeのGit Flow機能が内部でGitコマンドをどのように呼び出しているかに起因する可能性があります。

IV. non-fast-forwardマージを強制する設定方法 (SourceTree & Git Flow)

SourceTreeでGit FlowのFeatureブランチを確実にnon-fast-forwardマージで完了させるには、Gitのグローバル設定ファイル（.gitconfig）に直接設定を記述する必要があります。

1. .gitconfig の編集コマンド

以下のコマンドをターミナルまたはコマンドプロンプトで実行してください。

git config --global --add gitflow.feature.finish.no-ff true

解説:

• git config --global: Gitのグローバル設定に対して変更を加えることを意味します。この設定は、あなたのマシン上の全てのGitリポジトリに適用されます。
• --add gitflow.feature.finish.no-ff true: Git Flowのfeature finishコマンドに対して、non-fast-forwardマージを強制するno-ffオプションをtrueに設定するよう指示します。

このコマンドを実行すると、あなたのホームディレクトリにある.gitconfigファイルに以下の行が自動的に追加されます。

[gitflow "feature"]
    finish.no-ff = true

2. (Optional) .gitconfigファイルを直接編集する

コマンドの実行に抵抗がある場合や、設定内容を確認したい場合は、テキストエディタで.gitconfigファイルを直接開いて、上記の[gitflow "feature"]セクションを追加または編集することも可能です。

• .gitconfigファイルの場所は通常、Linux/macOSでは~/.gitconfig、WindowsではC:\Users\<ユーザー名>\.gitconfigです。

3. 補足: 通常のマージ設定との違い

通常のgit mergeコマンドでnon-fast-forwardマージを強制したい場合、[merge]セクションにff = falseを設定することがよくあります。

[merge]
    ff = false

しかし、Git Flowのfeature finishコマンドは、この[merge]セクションの設定とは独立して動作します。そのため、Git FlowのFeatureブランチ完了時にnon-fast-forwardマージを強制するには、gitflow.feature.finish.no-ff = trueという専用の設定が必要となるのです。

V. 設定の確認と動作検証

設定が正しく適用され、意図した通りにnon-fast-forwardマージが実行されるかを確認しましょう。

1. 設定内容の確認

以下のコマンドを実行することで、gitflow.feature.finish.no-ffの設定値を確認できます。

git config --global --get gitflow.feature.finish.no-ff

trueが返されれば、設定は正しく適用されています。

2. SourceTreeでの動作検証

実際に簡単なFeatureブランチを作成し、SourceTreeでそのブランチを完了させてみましょう。

1. 新しいFeatureブランチの作成:
   • developブランチから新しいFeatureブランチを作成します。（例: feature/test-non-ff）
2. コミットの追加:
   • feature/test-non-ffブランチでいくつかの変更を加え、コミットします。
3. Featureブランチの完了:
   • SourceTreeのGit Flowメニューから「Featureを完了する」を選択し、feature/test-non-ffブランチを完了させます。

完了後、SourceTreeのコミットグラフを確認してください。developブランチにFeatureブランチがマージコミットとして統合されていれば、設定は成功です。

VI. その他のGitクライアントやコマンドでの対応 (Optional)

SourceTree以外のGitクライアントや、コマンドラインで直接Git Flowを使用する場合も、non-fast-forwardマージは可能です。

• コマンドラインでのGit Flow:
  git flow feature finish <feature_name> --no-ff
  または、.gitconfigに今回の設定が適用されていれば、通常通りgit flow feature finish <feature_name>でnon-fast-forwardマージが実行されます。
• 一般的なGitマージコマンド:
  git merge --no-ff <branch_name>
  このコマンドは、Git Flowを使わない場合でも、任意のマージでnon-fast-forwardを強制する際に利用できます。

VII. まとめ

Git FlowワークフローにおいてFeatureブランチの履歴を明確に保つことは、プロジェクトの透明性、問題発生時の原因究明、そしてRevert作業の効率化に大きく貢献します。

本記事でご紹介した.gitconfigへの設定追加により、SourceTreeを使用している環境でもFeatureブランチを確実にnon-fast-forwardマージで完了させることが可能になります。これにより、より堅牢で管理しやすいGit履歴を構築し、開発効率を向上させることができるでしょう。