メインコンテンツへスキップ
AMPL/ dev
開発系講座一覧

はじめてのデプロイ

GitHub に置いた作品を、Vercel につないで置きます。置く前の仕上げの作業をビルドと呼びます。一度つなげば、GitHub に送るたびに、自動で置き直されます。

土曜の朝、佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)は、Vercel のページで、GitHub のアカウントを使って、アカウントを作りました。ログインの画面は、自分で読んで、自分で押しました。開いた画面の右上に、「New Project」というボタンがあります。

問い

佐藤さんの疑問

GitHub に置いた売れ残り帳を、Vercel に置くには、どう進めればいいんだろう。

段ボール箱を2つ積んだ台車の挿絵。

前の回で、置き場所を Vercel に決めました。この回では、はじめてのデプロイ(作品をサーバーに置いて、URL で開けるようにすること)をします。ここに書くのは進め方の例で、画面のボタンの名前は、サービスの更新で変わることがあります。

先に、置く版をそろえる

「いまパソコンにあるもの」と「GitHub に置いたもの」が、同じとは限りません。Vercel が受け取るのは、GitHub に置いたほうです。先に、Claude Code(会話で頼むと、作品を作ったり直したりしてくれる道具)に、置く準備を頼みます。

置く前に整えてもらう例
この作品を Vercel に置きます。置く前に、次のことを確かめて教えてください。
・写真を受け取って Claude API に送るサーバー側の仕組みが、Vercel で動く形になっているか。なっていなければ、どう直すか
・置くときに、ビルドが要るか。要るなら、何をするのか
・API キーの値が、どのファイルにも書かれていないか
・まだコミットしていない変更や、GitHub に送っていないコミットがないか
直す必要があれば、直す前に案を見せてください。

この依頼文は、説明のための架空の例です。

案を読んで直してもらったら、画面で確かめ、コミットして、GitHub にプッシュします(第5部の第3回と第8回)。

ビルド:置く前の、仕上げの作業

作品の材料から、配って使う形を作る作業を、ビルドと呼びます。英語の build は「組み立てる」という意味です。Vercel の公式の説明には、こう書かれています。

DOCUMENTATION

“This process compiles, bundles, and optimizes your application so it's ready to serve to your users.”

この作業で、作品を変換し、ひとまとめにし、整えて、使う人に届けられる形にします。

VercelBuilds(Vercel Docs)

同じ説明によると、HTML・CSS と、ブラウザで動く JavaScript だけでできたサイトなら、ビルドは要りません。売れ残り帳のように、サーバー側の仕組みがある作品は、作り方によって違います。要るかどうかは、上の依頼文で Claude に確かめてもらいました。

Vercel で、リポジトリを選ぶ

Vercel の公式の説明には、GitHub のリポジトリ(作品の置き場)を Vercel につなぐのは、ダッシュボード(自分の作品の一覧の画面)の右上にある「New Project」を押し、手順に沿って進めるだけ、と書かれています。佐藤さんは、次のように進めました。

  1. 「New Project」を押す。はじめは、GitHub とつなぐ許可を求められる。つなぐ範囲を選べるときは、urenokori だけを選ぶ
  2. 出てきたリポジトリの一覧から、urenokori(売れ残り帳のリポジトリの名前)を選ぶ
  3. 作品の名前と設定を確かめる。分からない欄は、推測で埋めず、Claude に「この作品なら、ここは何にすればよいか」と聞く。鍵は、次の回で入れる
  4. 「Deploy」を押す

しばらくすると、Vercel の画面に、urenokori のような作品の名前のあとに .vercel.app が付いた URL が出ます。Vercel が用意した住所です。佐藤さんがスマホで開くと、売れ残り帳の画面が出ました。

送るたびに、置き直される

一度つなぐと、あとは GitHub に送るだけで、Vercel が置き直してくれます。

vercel.com/docs/git
Vercel の公式の説明のページ「Deploying Git Repositories with Vercel」。Vercel allows for automatic deployments on every branch push と書かれ、プッシュのたびのプレビューと、本番の枝の最新の変更での本番の置き直しが、箇条書きになっている。
Vercel の公式の説明のページ(英語、2026年11月11日に撮影)。枝にプッシュするたびに、自動で置き直すと書かれています。ログインしなくても読めます。

同じ説明によると、本番の枝(ふつうは main。第5部の第5回で見た、本線の枝)に送ったものは本番に、ほかの枝に送ったものは試しの版(プレビュー)になります。プレビューは、第7部の第5回で扱います。

送るたびに、置き直される

GitHub とつないだあと

手元 コミットする GitHub プッシュで届く Vercel ビルドして置き直す プッシュ 自動で main に送る → 本番が置き直される ほかの枝に送る → 試しの版 手元 コミットする GitHub プッシュで届く Vercel ビルドして置き直す プッシュ 自動で main に送る → 本番が置き直される ほかの枝に送る → 試しの版
図1一度つなげば、あとは第5部と同じく、コミットしてプッシュするだけです。

失敗したら、止まった段を探す

ビルドに失敗すると、本番は置き換わりません。Vercel の公式の説明には、ビルドが失敗したり時間切れになったりしたときは、ダッシュボードに原因を調べるための記録(ログ)が出る、と書かれています。

ログの最後のほうにある、エラー(うまく動かなかったという知らせ)の文を、第4部の第9回で見たとおり、そのまま Claude に渡します。鍵のような秘密の値が写っていないかは、渡す前に確かめます。

GitHub のリポジトリを Vercel につないで「Deploy」を押すと、作品が置かれ、URL が付きます。一度つなげば、送るたびに置き直されます。

注意

ただし、最初のデプロイは、いきなり本番になる

Vercel の公式の説明には、新しく作った作品の最初のデプロイは、必ず本番になる、と書かれています。試しの版から始まるわけではありません。

最初に置く前に、第5部の第9回の確かめ(鍵、人の情報、本物の数字が入っていないか)を、もう一度します。置いたら、付いた URL を開いて、試し用の数字で、画面が出るかを確かめます。

次回の問い

佐藤さんの次の疑問です。置いた売れ残り帳で写真を撮ると、「読み取りに失敗しました」と出ました。手元では動いていたのに、なぜでしょうか。

参考

Deploying Git Repositories with Vercel(Vercel Docs)
GitHub のリポジトリをつないで置く手順と、送るたびの自動の置き直し。英語。2026年11月11日に確認。
vercel.com · vercel.com
Builds(Vercel Docs)
ビルドとは何か、失敗したときのログ。英語。2026年11月11日に確認。
vercel.com · vercel.com
Vibe Coding 用語集:ビルド
ビルドの説明。
AMPL · Web

このレッスンは役に立ちましたか?