「マージ=公開」ではない — 反映を必ず確かめる習慣
「マージした」は「公開された」ではありません。取り込んでも本番に出ないことがある。連続マージで公開が打ち消し合った自社の実例と、公開URLを自分の目で見るまで完了と言わない運用の習慣を、一人会社の一次体験としてまとめました。
「マージした」は「公開された」ではありません。
コードを本流に取り込んでも、本番のサイトには一秒も反映されていない――そういうことが、普通に起こります。
実は私たち自身が、自社サイトでこれをやりました。
手元では直った。レビューも通った。マージも済んだ。
なのに、お客さまが見る画面は古いまま。
この記事は、その失敗の話です。
そして、そこから生まれた「自分の目で見るまで完了と言わない」という、地味だけど一番効く習慣の話です。
🧩マージと公開は別の工程です
マージはコードを取り込む工程で、公開は本番へ反映する別の工程。自動でつながっている保証は、どこにもありません。
まず、ことばの整理から。
「マージ」はコードを本流に取り込む作業です。設計図を確定させる段階、と言ってもいい。
「デプロイ(公開)」は、その設計図を実際のサーバーに反映して、来訪者に見える形にする作業です。
図面ができても、現場で建てなければ建物は建たない。
マージと公開の関係は、それとまったく同じです。
ややこしいのは、多くのホスティング環境ではマージすると自動で公開まで進む、という点。
だから「マージ=公開」という感覚が、いつのまにか身についてしまう。
でも、自動公開がオフの構成や、公開処理が別の仕組みに分かれている構成では話が変わります。
マージしただけでは、本番は一歩も動きません。
ここに、認識のズレが生まれます。
🔧自社サイトで踏んだ実例
私たちのサイトはマージしても本番が動かない構成。ある修正がマージ済みなのに、公開ページに出ない状態が続きました。
私たちの自社サイト(i-willink.com)は、コードをマージしただけでは本番が更新されません。
公開を担うのは、マージとは別に動く専用のジョブです。
そこを分かっていませんでした。
ある画像まわりの修正が、マージ済みなのに公開ページには出ていない。
その状態が、しばらく続きました。
ログを見返すと、修正自体はちゃんと本流に入っている。
それでも本番のURLを開くと、直っていない。
「取り込んだのに、なぜ?」――原因にたどり着くまでの時間が、じわじわ溶けていきました。
マージ完了の、あの緑色のチェックマーク。
あれを見て安心してしまったのが、そもそもの油断でした。
⚡連続マージがデプロイを打ち消すことがあります
立て続けのマージで、先の公開処理が止められ、後の処理には出すものがない。どちらも公開されず、打ち消し合いました。
原因のひとつは、修正を立て続けにマージしたことでした。
公開ジョブには「同時に走らせない」仕組みが入っていることがあります。
新しい公開処理が始まると、先に動いていた古い処理を途中で止める。
無駄な二重公開を防ぐための、理にかなった挙動です。
問題は、このとき何が起きたか。
最初のマージで始まった公開ジョブが、直後のマージにキャンセルされました。
ところが後から来たマージには、公開すべき中身の変更が入っていなかった。
先行ジョブは止められた。後続ジョブは出すものがない。
結果、どちらの公開も成立しなかった。
修正は確かにあるのに、本番には出ない。――打ち消し合いです。
こうしたビルドやデプロイの並行制御そのものは、各フレームワークの公開ドキュメントでも前提として語られる普通の話です。
特別な不具合ではありません。仕組みを知らないと足をすくわれる、というだけのこと。
👀公開URLを自分の目で見るまで「完了」と言わない
マージ完了では終わらせない。本番URLを実際に開き、直っているとこの目で確かめるまで、完了と報告しない習慣です。
この失敗のあと、運用にルールをひとつ足しました。
「マージした」で終わらせない。
本番の公開URLを実際に開いて、直っているかをこの目で確かめるまでは、完了と報告しない。
たったこれだけです。
やることは、順番に3つ。
公開に影響する変更を出したら、まず公開ジョブがちゃんと発火したかを見る。
発火していなければ、公開処理を明示的に起動し直す。
そのうえで本番URLを開き、期待どおりの表示になっているかを確かめる。
ログの緑色や「マージ完了」の通知を、公開の証拠として扱わない。
たったそれだけの切り替えですが、効き目はまるで違いました。
🏢中小企業でも起きる「公開したつもり」
文言修正も営業時間の更新も同じ。制作会社が「対応した」と言っても、実物を開くまで古いままのことがあります。
これ、エンジニアだけの話だと思いますか?
いいえ。どんな会社でも起こります。
ホームページの文言を直した。営業時間を更新した。キャンペーンのバナーを差し替えた。
制作会社や担当者が「対応しました」と言っても、実際のページを開いて確かめないと、古いままのことは普通に起こります。
承認と公開のタイミングがずれる。キャッシュが残る。公開ボタンの押し忘れ。
原因は、いくらでもあります。
だからおすすめしたいのは、とても素朴な習慣です。
「直しました」と聞いたら、その場でスマホでもパソコンでも、実際のページを開いて自分の目で見る。
可能なら、社内の別の人にも一度見てもらう。
この一手間が、「お客さまだけが古い情報を見ていた」という事故を、確実に減らします。
✅まとめ:完了の定義を「公開の実物」に置く
完了の基準を、通知やチェックマークではなく、お客さまが見る実物の画面に置く。それだけで事故は確実に減ります。
マージや承認は、途中の工程です。ゴールではありません。
ゴールは、お客さまが見る画面が、正しく変わっていること。
私たちは自社サイトで一度これを取り違えて、修正が本番に出ないまま時間を溶かしました。
そこから学んだのは、シンプルな原則ひとつです。
「完了」の定義を、通知やチェックマークではなく――「公開されている実物」に置く。
作業した本人の「やりました」を疑うのではありません。
仕組みは、思ったとおりに動かないことがある。そう前提を置くだけ。
そのうえで、公開URLを自分の目で確かめる。
地味です。でも、一番効きます。
あなたのサイトの更新も、今日ぜひ一度、実物を開いて確かめてみてください。
開発パートナーを探していますか?
AIでプロダクトを最速で形にしませんか?
最短1週間でMVPを開発。アイデアの検証から本番リリースまで、i-Willinkがフルサポートします。まずはお気軽にご相談ください。
無料で相談する