✨

release → master → develop のマージでハマった話

に公開

はじめに

Gitでブランチ運用をしている際、順番にマージしたはずなのに、なぜか変更が入らない、という体験をしました。

よくよく調べてみた結果、「なるほど」と、改めてGitの概念を理解できた気がするので、自分へのメモとしてまとめます。

やってしまった手順

今回、行った操作は以下。
デプロイ作業の兼ね合いで、下記の流れで行おうとした。

  1. release に修正内容をコミット
    ※ develop にはまだ入れていない
  2. release → master にマージ
  3. develop → release にマージ(次のリリース準備のために)
  4. 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に修正を最初にコミットする
  • せめて、下記の順番で行う
    1. release に修正内容をコミット
    2. release → master にマージ
    3. master → develop にマージ
    4. develop → release にマージ(次のリリース準備のために)

学んだこと

  • Gitはコードではなく履歴をマージしている
  • 「すでに見たコミット」は二度とマージされない
  • ブランチ運用で一番重要なのは最初にどこへコミットするか

Discussion