Vercelデプロイとは、git の push や CLI から渡したコードを Vercel が組み立てて公開URLに出す操作です。
- git 連携と CLI(
vercel・vercel --prod)で、Preview と Production のどちらに出るかが決まる仕組み - 環境変数を変えた後に再デプロイが要る理由と、公開用の値(
NEXT_PUBLIC_)の落とし穴 - 本番を前の版へ戻す道(Instant Rollback と git revert)の使い分けと、当社が実際に 404 を出して戻した記録(社の実測 2026-10-26)
当社は AIエージェント に Vercel の deploy と確かめを任せています。その中で、git 連携が要らない build を本番に出して管理サイトを 404 にした事、計測の数を読み違えかけた事、環境変数の出し忘れで頁の中身が変わらなかった事を踏みました。公式の文書で確かめた仕組みと、その記録を並べます。
Vercelデプロイの仕組み:Preview と Production
Vercel の deployment は、プロジェクトの build が成功した結果です。deploy のたびに固有の URL が作られます。環境は Local・Preview・Production の 3 つが既定で用意されています(Vercel Docs「Deploying to Vercel」・2026-11-11 に開いて確かめた)。
どの操作でどちらに出るかを表にします。
| 操作 | 出る先 | 公式に書いてある事 |
|---|---|---|
本番の枝(既定は main)へ push・merge | Production | 本番の枝へ merge するたびに Production の deployment が作られる |
本番の枝以外の枝へ push・PR | Preview | 本番の枝以外は Preview の枝として出る。枝ごとに URL が付く |
vercel(vercel deploy) | Preview | Preview の deployment を作る。stdout は deployment の URL |
vercel --prod | Production | 本番のドメインに向けた deployment を作る。新しいプロジェクトの最初の deploy は --prod を省いても Production |
vercel --prod --skip-domain | Production(ドメインは付けない) | 本番のドメインの自動の割り当てを止める。後で vercel promote で割り当てる |
Deploy Hooks の URL を叩く | 設定した枝 | git の接続が要る。新しい commit は要らない |
出典: Vercel Docs「Deploying Git Repositories with Vercel」・Vercel Docs「vercel deploy」・Vercel Docs「Environment variables」・Vercel Docs「Deploying to Vercel」(いずれも 2026-11-11 に開いて確かめた)
本番の枝は、新しいプロジェクトでは main、無ければ master、無ければリポの既定の枝の順に選ばれます。Project Settings の Environments の Production にある Branch Tracking で変えられます(同上)。
git 連携で本番に出す手順と、出したくない時の止め方
- ダッシュボードの New Project からリポを選び、Framework Preset・root のディレクトリ・Build の設定・環境変数を確かめて Deploy を押す
- 以後は、作業の枝へ push すると Preview、本番の枝へ merge すると Production が作られる
- Preview の URL で確かめてから本番の枝へ merge する
自動の deploy を止めたい枝は、vercel.json の git.deploymentEnabled に枝の名前と false を書きます。値を false にすると全部の枝の自動の deploy が止まります(Vercel Docs「Git Configuration」・2026-11-11 に開いて確かめた)。リポとの接続そのものは、Settings の Git にある Connected Git Repository の Disconnect で外せます(Vercel Docs「Git settings」・2026-11-11 に開いて確かめた)。
{
"git": {
"deploymentEnabled": { "main": false }
}
}
当社の記録:凍結した管理サイトが 404 になった
当社の旧い管理サイト(Vercel の既定のドメインで出していた面の 1 つ)が、9月20日から 404 を返していました。もう手を入れない面として扱っていましたが、そのプロジェクトに繋がったリポの main へ別の作業の push が入り、git 連携がそのたびに中身の無い build を本番に出していました。本番に出た回数は 8 回です(社の実測 2026-10-26)。
git 連携は、本番の枝への push を全部本番にします。触らないつもりの面ほど、連携が生きている事を忘れます。凍結した面は、連携を外すか、git.deploymentEnabled で本番に出す枝を絞ってから置いておく、が当社の教訓です。
環境変数と再デプロイ
Vercel の環境変数は、Production・Preview・Development(と custom environments)のどれに効かせるかを選んで置きます。環境変数の変更は前の deployment には効かず、新しい deployment にだけ効きます。NEXT_PUBLIC_ で始まる変数は、Next.js が build の時に頁の側の bundle へ埋め込みます。ダッシュボードで変えても効かない時は再デプロイ(Redeploy)する、と公式の困った時の表にあります(Vercel Docs「Environment variables」・2026-11-11 に開いて確かめた)。
| 当社で起きた事 | 原因 | 直し方 |
|---|---|---|
Production の env に公開用の値を入れたのに、頁に出ない | NEXT_PUBLIC_ の値は build の時に埋め込まれる。今の deployment は前の値で組まれたまま | 値を入れた後に再デプロイする |
会員サイトの一部の機能をホストで絞って出したら、許可していないホストでも 200 が返った | 許可していないホストに、中身の無い頁(soft 404)を 200 で返していた | env を外して再デプロイで戻す。ホストごとに本当の 404 を返す直しの後に入れ直す |
出典: 社の実測 2026-09-21(公開用の値と再デプロイ)・社の実測 2026-10-27(ホストで絞った機能の確かめ)
後者は、deploy の後の確かめで見つけました。env を外して再デプロイし、全部のホストで 404、ログインの頁は 200 に戻った事を確かめました。ホストごとに本当の 404 を返すように直した後で env を入れ直し、許可した 3 つのホストは 200、許可していない 2 つは 404 を返す事を確かめています(社の実測 2026-10-27)。200 が返る事だけを見ると、空の頁を「開いた」と読みます。許可していない側が 404 になる事まで確かめるのが要点でした。
本番を前の版へ戻す:Instant Rollback と git revert
Instant Rollback は、前に本番を出していた deployment へドメインを向け直す戻し方で、build をやり直しません。そのため環境変数は戻した先の build のままで、プロジェクトの設定で変えた値は反映されません。戻した後は本番のドメインの自動の割り当てが止まり、本番の枝へ push しても戻した版は置き換わりません。元に戻すには、別の deployment を Promote します(ダッシュボードの Manage か vercel promote)。どこまで前へ戻せるかはプランで違います(Vercel Docs「Performing an Instant Rollback on a Deployment」・Vercel Docs「Promoting Deployments」・2026-11-11 に開いて確かめた)。
| 戻し方 | build | 向く時 | 気をつける事 |
|---|---|---|---|
Instant Rollback(前の deployment を本番に戻す) | やり直さない(ドメインの向け直し) | 急ぎ。壊れた本番をすぐ止めたい | 戻した後は自動の割り当てが止まる。直した版を Promote して解く |
git revert を本番の枝に入れる | やり直す(新しい Production の deployment) | ふだん。履歴に戻した事が残る | build が通るまで壊れた本番が出たまま |
Preview を Promote to Production | やり直す | 本番の枝でない枝を一時的に本番にしたい | Preview の環境変数は使えず、Production の値で組まれる |
出典: Vercel Docs「Performing an Instant Rollback on a Deployment」・Vercel Docs「Promoting Deployments」(2026-11-11 に開いて確かめた)・社の実測 2026-10-18・2026-10-29(当社の戻し方の使い分け)
当社は、急ぎは Promote で前の deployment を本番に戻し、ふだんは git revert を main に入れて Vercel に出し直させています。どちらの時も、本番に出す前に今の本番の deployment の id を控えてから撃ちます。控えが無いと、戻す先を一覧から探す手間が急ぎの時に重なります(社の実測 2026-10-18・2026-10-29)。
CI から deploy する時の札の置き場
CI から vercel --prod を撃つには、Vercel の札(token)が要ります。当社は CI が GitHub に持っていた VERCEL_TOKEN の写しを消しました。今は CI が Workload Identity Federation で Google Cloud に入り、その後 Secret Manager から札を読む形です(社の実測 2026-10-18)。
移す時に、team の札を API で新しく作ろうとして forbidden で断られました。そのため既存の値をそのまま移しています。その札は期限が無い(expiresAt が null)事も確かめました(社の実測 2026-10-18)。期限の無い札は、置き場を一か所に絞る事が漏れた時の傷を小さくする手になります。
deploy の後の数を読む時の注意
Vercel の Web Analytics は、頁に @vercel/analytics を入れる(または計測の script を置く)事で page view を数え始めます。正しく入っていれば、頁を開いた時に計測の送信が browser の Network に見えます(Vercel Docs「Getting started with Vercel Web Analytics」・2026-11-11 に開いて確かめた)。
当社は deploy の後の確かめで vercel metrics の vercel.analytics.page_view.count を引き、計測の script(/_vercel/insights)を入れていないサイトでは常に 0 が返る事を見ました。来訪が無い 0 ではなく、数えていない 0 です。リクエスト数(vercel.request.count)は有料の Observability Plus が要り、payment_required が返りました(社の実測 2026-10-19)。0 と読む前に、頁に script が入っているかを先に確かめます。計測を GA4 で取る場合の読み方は GA4 MCP の頁にまとめています。
よくある質問
Vercel で main に push すると必ず本番に出ますか?
git 連携が生きていて main が本番の枝なら、push のたびに Production の deployment が作られます。当社では、手を入れないつもりの管理サイトに別の作業の push が入り、中身の無い build が本番に 8 回出て 404 になりました(社の実測 2026-10-26)。止めたい時は git.deploymentEnabled で枝を絞るか、リポの接続を外します。
Vercel で環境変数を変えたのに反映されないのはなぜですか?
環境変数の変更は新しい deployment にだけ効き、今の deployment は前の値で組まれたままだからです(Vercel Docs・2026-11-11 に確かめた)。当社でも NEXT_PUBLIC_ の値を Production に入れた後、再デプロイするまで頁に出ませんでした(社の実測 2026-09-21)。
Vercel の Instant Rollback の後、push しても本番が変わらないのはなぜですか?
戻した後は本番のドメインの自動の割り当てが止まるためです。別の deployment を Promote する(ダッシュボードの Manage か vercel promote)と、自動の割り当てが戻ります(Vercel Docs・2026-11-11 に確かめた)。
vercel と vercel --prod の違いは何ですか?
vercel は Preview の deployment を作り、vercel --prod は本番のドメインに向けた deployment を作ります。新しいプロジェクトの最初の deploy は、--prod を省いても Production になります(Vercel Docs・2026-11-11 に確かめた)。
Vercel の page view が 0 なのは来訪が無いからですか?
そうとは限りません。当社では、計測の script を入れていないサイトで page view の数が常に 0 でした(社の実測 2026-10-19)。0 と読む前に、頁に @vercel/analytics などの計測が入っているかを確かめます。
出典
- Vercel Docs「Deploying to Vercel」 https://vercel.com/docs/deployments(2026-11-11 に開いて確かめた・deployment の定義・作り方・Local/Preview/Production)
- Vercel Docs「Deploying Git Repositories with Vercel」 https://vercel.com/docs/git(2026-11-11 に開いて確かめた・本番の枝と Preview の枝・本番の枝の選ばれ方と変え方)
- Vercel Docs「Git Configuration」 https://vercel.com/docs/project-configuration/git-configuration(2026-11-11 に開いて確かめた・
git.deploymentEnabled) - Vercel Docs「Git settings」 https://vercel.com/docs/project-configuration/git-settings(2026-11-11 に開いて確かめた・リポの接続の外し方)
- Vercel Docs「vercel deploy」 https://vercel.com/docs/cli/deploy(2026-11-11 に開いて確かめた・
vercel・--prod・--skip-domain・stdout) - Vercel Docs「Environment variables」 https://vercel.com/docs/environment-variables(2026-11-11 に開いて確かめた・環境ごとの値・新しい deployment にだけ効く事・
NEXT_PUBLIC_と再デプロイ) - Vercel Docs「Performing an Instant Rollback on a Deployment」 https://vercel.com/docs/instant-rollback(2026-11-11 に開いて確かめた・戻し方・戻した後の自動の割り当て・戻しの解き方)
- Vercel Docs「Promoting Deployments」 https://vercel.com/docs/deployments/promoting-a-deployment(2026-11-11 に開いて確かめた・Instant Rollback と Promote の違い・build のやり直しの有無)
- Vercel Docs「Getting started with Vercel Web Analytics」 https://vercel.com/docs/analytics/quickstart(2026-11-11 に開いて確かめた・計測の package と script)
- 社の実測 2026-10-26(旧い管理サイトの 404 と、git 連携が本番に出した build)
- 社の実測 2026-10-19(page view の偽の 0・リクエスト数の
payment_required) - 社の実測 2026-09-21(
NEXT_PUBLIC_の値と再デプロイ) - 社の実測 2026-10-27(ホストで絞った機能の soft 404 と、戻しと入れ直しの確かめ)
- 社の実測 2026-10-18(CI の札の置き場の移し替え・札の期限)
- 社の実測 2026-10-18・2026-10-29(戻し方の使い分けと、出す前の id の控え)