release → master → develop のマージでハマった話
はじめに
Gitでブランチ運用をしている際、順番にマージしたはずなのに、なぜか変更が入らない、という体験をしました。
よくよく調べてみた結果、「なるほど」と、改めてGitの概念を理解できた気がするので、自分へのメモとしてまとめます。
やってしまった手順
今回、行った操作は以下。
デプロイ作業の兼ね合いで、下記の流れで行おうとした。
- release に修正内容をコミット
※ develop にはまだ入れていない - release → master にマージ
- develop → release にマージ(次のリリース準備のために)
- master → develop にマージ
上記の流れで行った場合、4の時点でmasterの修正がdevelopに正しく入らないという状態になった。
Gitは何を見てマージしているか
Gitは、「コードの中身」ではなく、「そのコミットをすでに見たかどうか」を基準にマージする。Gitが信頼しているのは コミットの履歴(グラフ) 。
3のdevelop → release で何が起きていたか
3の直前の状態
この時点の状態を簡略化すると、次のようになる。
-
develop
→ 古い状態(A) -
release
→ develop から分岐したあと
→ 修正コミット B が追加されている
→ 状態:A → B
ここで大事なのは、「release は develop を元に作られている」という点。
Gitはマージ時に何を比較しているか
Gitはマージの時に、ファイルの中身だけを単純に比較しているわけではない。
実際には、次のような視点で履歴を見ている。
- develop にしか存在しないコミットはあるか
- release にしか存在しないコミットはあるか
- 互いに持っていないものを取り込む必要はあるか
develop → release をしたときの Git の判断
この時、Gitが見ている履歴は、
-
release が持っているコミット
→ A, B -
develop が持っているコミット
→ A
つまり、
- develop にあって
- release に まだ入っていない コミット
は、1つも存在しない。
Gitはこれを次のように判断する。
develop の履歴は、すでに release の履歴の中に完全に含まれている。だから、追加するものが何もない
「追加するものが何もない」けどマージはした
ここで言う「追加するものが何もない」は、「行単位のコード差分がない」ではなく、コミット単位で取り込む対象が存在しないという意味。
一見すると、「何も起きていない」ように見えるが、マージ作業自体は行った履歴が残る。
4のmaster → develop でなぜ入らなかったのか
ここが、一番混乱したポイントだった。
- 修正コミットは release で作られた
- release → master で master に入った
- その後、develop → release を実行した
この履歴を見て Git はこう判断する。
この修正コミットは、すでに release 経由で develop と“共有済み”
実際にコードが入っていなくても、履歴上、ブランチが交差していれば「処理済み」扱いになる。
そのため、master → develop をしても、Git的には 「新しいコミットがない」 と判断されてしまった。
何が問題だったか
問題は、順番ではなく、最初にどこへコミットしたか。
- 修正は release にだけ存在
- develop がその修正を「正規ルート」として一度も受け取っていない
それなのに、履歴上は「もう合流したこと」になってしまった。
どうすれば良かったか
- 基本的には、王道パターンである、developに修正を最初にコミットする
- せめて、下記の順番で行う
- release に修正内容をコミット
- release → master にマージ
- master → develop にマージ
- develop → release にマージ(次のリリース準備のために)
学んだこと
- Gitはコードではなく履歴をマージしている
- 「すでに見たコミット」は二度とマージされない
- ブランチ運用で一番重要なのは最初にどこへコミットするか
Discussion