なぜ Git と Neon でブランチをそろえるのか
Git のブランチは開発の日常になりました。では、同じ気軽さでデータベースまで分岐できたら、開発は何が変わるのでしょうか。幹と枝の役割分担を、1 本の木からたどりましょう。
各ブロックや矢印をクリックすると、その仕組みの説明がここに表示されます。
この図をテキストで読む
構成図「Git のブランチ と Neon のブランチを 1対1 で対応させる」。ブロック5個、つながり4本。 【ブロック】 - main: Git: main ／ Neon: production - staging: Git: staging ／ Neon: staging - dev/alice: 開発者 alice 専用 - dev/bob: 開発者 bob 専用 - preview/pr-123: PR #123 専用・使い捨て 【図の符号】赤紫の枠=データの置き場 / 破線の枠=外部のサービス 【流れ】 - 永続の幹（消さない）: main → staging - 開発者ブランチ（準永続）: main → staging → dev/alice - 使い捨て（PRごと）: main → preview/pr-123
PRごとに『作ってはすぐ壊す』流れ（GitHub 連携）
各ステップ・参加者・分岐をクリックすると、その仕組みの説明がここに表示されます。
この図をテキストで読む
シーケンス図「PRごとに作って、用が済んだら壊す（GitHub 連携）」。参加者4人、ステップ10個。 【参加者】（左から右） - 開発者: PRを出す人 - GitHub: リポジトリ / PR - CI: GitHub Actions - Neon: DBブランチ基盤 【流れ】（上から下へ） ── ① PRを開く → 使い捨てDBを自動で作る ── 1. 開発者 → GitHub: feature ブランチを push、PRを作成 2. GitHub → CI: PR open イベントで CI を起動 3. CI → Neon: preview/pr-123 を作成（本番のコピー） 4. Neon → CI: 接続URLを返す（即時）（応答） 5. CI（自身で処理）: マイグレーション適用＋テスト＋プレビュー 6. CI → GitHub: プレビューURLをPRにコメント（応答） ── ② PRをマージ／クローズ → 使い捨てDBを自動で壊す ── 7. 開発者 → GitHub: PRをマージ（または close） 8. GitHub → CI: merged / closed イベント 9. CI → Neon: preview/pr-123 を削除 10. Neon → CI: 片付け完了（待機ぶんは scale to zero）（応答）
永続ブランチ と 使い捨てブランチ を見くらべる（早見表）
各セルをクリックすると、その意味や詳しい説明がここに表示されます。
この図をテキストで読む
比較表。2列 × 8行。 【列】 1. 永続ブランチ（ずっと残す） 2. 使い捨てブランチ（PRの間だけ） 【比較】（観点ごとに） ■ 寿命 - 永続ブランチ: ずっと（消さない） - 使い捨てブランチ: PRの間だけ ■ 例 - 永続ブランチ: main / staging / dev/alice - 使い捨てブランチ: preview/pr-123 ■ 数 - 永続ブランチ: 少数 / 環境＋人数ぶん - 使い捨てブランチ: PRの数だけ増減 ■ Gitとの対応 - 永続ブランチ: 長命ブランチに対応 / main / staging - 使い捨てブランチ: feature / PR と1対1 ■ 名前合わせ - 永続ブランチ: ゆるくてよい / 手動・少数 - 使い捨てブランチ: 厳密に合わせる / CIが機械照合 ■ 作成・削除 - 永続ブランチ: 手動・たまに - 使い捨てブランチ: CIが自動で作成＆削除 ■ 鮮度の保ち方 - 永続ブランチ: 定期リフレッシュが必要 / 再生成 / reset from parent - 使い捨てブランチ: 常に新鮮 / 毎回作り直す ■ コスト - 永続ブランチ: 常時ぶん（ただし安い） / 待機は scale to zero - 使い捨てブランチ: PR中だけ・差分課金 【観点】 - 永続を見る: 永続ブランチ - 使い捨てを見る: 使い捨てブランチ
『永続』も定期的に捨てる
常設の dev ブランチを不変だと思わないのが勘どころです。作るのも消すのも一瞬なので、週次などで作り直すと本番相当の新鮮なデータで開発でき、『手元では動くのに本番で壊れる』を避けられます。
押さえておきたい用語
- コピーオンライト
- 使い捨てブランチ（ephemeral）
- プレビュー環境
- reset from parent
- scale to zero
- マイグレーション
『データベース のまとめ読み』を読み終えました。
データベース の記事 11 本を、行き来せずひととおり読み終えられます。