deploy-to-vercel

pjt222

更新于 2 days ago

5 次查看

其他general

关于

This skill deploys Next.js applications to Vercel, handling project linking, environment variables, and deployment configurations. It's used for initial deployments, setting up preview deployments for pull requests, and managing custom domains. Developers should use it when they need to automate Vercel hosting and CI/CD workflows for their Next.js projects.

快速安装

Claude Code

技能文档

name: deploy-to-vercel description: > Next.jsアプリケーションをVercelにデプロイします。プロジェクトのリンク、環境変数、プレビューデプロイメント、カスタムドメイン、本番デプロイメントの設定を扱います。Next.jsアプリを初めてデプロイするとき、プルリクエスト用のプレビューデプロイメントをセットアップするとき、カスタムドメインを設定するとき、またはVercel本番デプロイメントの環境変数を管理するときに使用します。 locale: ja source_locale: en source_commit: 6f65f316 translator: claude-opus-4-6 translation_date: 2026-03-16 license: MIT allowed-tools: Read Write Edit Bash Grep Glob metadata: author: Philipp Thoss version: "1.0" domain: web-dev complexity: basic language: TypeScript tags: vercel, deployment, nextjs, hosting, ci-cd

Vercelへのデプロイ

Next.jsアプリケーションを本番設定でVercelにデプロイします。

使用タイミング

Next.jsアプリを初めてデプロイするとき
プルリクエスト用のプレビューデプロイメントをセットアップするとき
カスタムドメインを設定するとき
本番環境の環境変数を管理するとき

入力

必須: ローカルで正常にビルドされるNext.jsアプリケーション
必須: GitHubリポジトリ（推奨）またはローカルプロジェクト
オプション: カスタムドメイン
オプション: 本番用の環境変数

手順

ステップ1: ローカルビルドの確認

npm run build

期待結果： ビルドがエラーなしで成功します。

失敗時： デプロイ前にビルドエラーを修正してください。よくある原因：TypeScriptエラー、依存関係の不足、無効なインポート。

ステップ2: Vercel CLIのインストール

npm install -g vercel

期待結果： vercelコマンドがグローバルに使用可能で、vercel --versionでインストールされたバージョンが表示されます。

失敗時： 権限エラーが発生する場合はsudo npm install -g vercelを使用するか、npmをユーザーローカルプレフィックスを使用するように設定してください。node --versionでNode.jsがインストールされているか確認してください。

ステップ3: リンクとデプロイ

# Vercelにログイン
vercel login

# デプロイ（初回：プロジェクトを作成）
vercel

# プロンプトに従う：
# - Set up and deploy? Y
# - Which scope? (アカウントを選択)
# - Link to existing project? N (新規プロジェクトの場合)
# - Project name: my-app
# - Directory: ./
# - Override settings? N

期待結果： プレビューURLが提供されます（例：https://my-app-xxx.vercel.app）。

失敗時： vercel loginが失敗する場合は、インターネット接続を確認してブラウザベースの認証を試してください。デプロイが失敗する場合は、ビルド出力のエラーを確認してください。Vercelはクリーンな環境を使用するため、すべての依存関係がpackage.jsonに含まれている必要があります。

ステップ4: 環境変数の設定

# 環境変数の追加
vercel env add DATABASE_URL production
vercel env add API_KEY production preview

# 環境変数の一覧表示
vercel env ls

またはVercelダッシュボード経由で設定：Project Settings > Environment Variables。

期待結果： vercel env lsが正しい環境（production、preview、development）に設定された必要なすべての環境変数を表示します。

失敗時： 変数がランタイムに表示されない場合は、対象環境が一致しているか確認してください（productionとpreview）。変数を追加した後は再デプロイしてください。既存のデプロイメントは新しい変数を自動的に取得しません。

ステップ5: 本番デプロイ

vercel --prod

期待結果： 本番URLが使用可能になります（例：https://my-app.vercel.app）。

失敗時： vercel logsまたはVercelダッシュボードでデプロイログを確認してください。よくある問題として、本番環境での環境変数の欠落やローカルセットアップとは異なるビルドコマンドがあります。

ステップ6: 自動デプロイ用のGitHub接続（推奨）

https://vercel.com/new にアクセス
GitHubリポジトリをインポート
Vercelが自動的にデプロイします：
- mainへのプッシュ → 本番デプロイメント
- プルリクエスト → プレビューデプロイメント

期待結果： VercelダッシュボードにGitHubリポジトリが接続されて表示され、mainへの以降のプッシュが自動的に本番デプロイメントをトリガーします。

失敗時： リポジトリがインポートリストに表示されない場合は、Vercel GitHubアプリがリポジトリへのアクセス権を持っているか確認してください。GitHub Settings > Applications > Vercelでアクセスを許可してください。

ステップ7: カスタムドメインの設定

vercel domains add my-domain.com

またはダッシュボード経由で：Project Settings > Domains。

Vercelの指示通りにDNSレコードを更新します（通常はCNAMEまたはAレコード）。

期待結果： vercel domains lsにカスタムドメインが設定済みとして表示され、DNS伝播後（最大48時間）にドメインがVercelデプロイメントに解決されます。

失敗時： ドメインに「Invalid Configuration」と表示される場合は、DNSレコードがVercelの指示と完全に一致しているか確認してください。dig my-domain.comまたはオンラインDNSチェッカーを使用して伝播を確認してください。

ステップ8: 設定の最適化

高度な設定のためにvercel.jsonを作成します：

{
  "framework": "nextjs",
  "regions": ["iad1"],
  "headers": [
    {
      "source": "/api/(.*)",
      "headers": [
        { "key": "Cache-Control", "value": "no-store" }
      ]
    }
  ]
}

期待結果： vercel.jsonがプロジェクトルートに保存され、次のデプロイメントで設定が反映されます（Vercelダッシュボードのビルドログで確認可能）。

失敗時： 設定が無視される場合は、jq . vercel.jsonでvercel.jsonが有効なJSONであるか確認してください。一部の設定がnext.config.tsに移動している可能性があるため、お使いのフレームワークバージョンのVercelドキュメントを確認してください。

バリデーション

npm run buildがローカルで成功する
プレビューデプロイメントが機能してアクセス可能
本番デプロイメントがアプリケーションを正しく提供する
本番環境で環境変数が使用可能
カスタムドメインが解決される（設定した場合）
GitHubインテグレーションがプッシュ時にデプロイをトリガーする

よくある落とし穴

Vercelでビルド失敗するがローカルでは成功する: Vercelはクリーンな環境を使用します。すべての依存関係がpackage.jsonに含まれており、グローバルにインストールされているだけでないことを確認してください。
環境変数の欠落: 変数は.env.localだけでなくVercelにも追加する必要があります。環境（production、preview、development）ごとに変数セットが分かれています。
Node.jsバージョンの不一致: Project SettingsまたはNode.jsのバージョンをpackage.jsonのenginesフィールドに設定してください。
大きなデプロイメント: Vercelにはサイズ制限があります。.vercelignoreを使用して不要なファイルを除外してください。
APIルートのタイムアウト: VercelサーバーレスファンクションはHobbyプランで10秒のタイムアウトがあります。最適化するかアップグレードしてください。

GitHub 仓库

pjt222/agent-almanac

路径: i18n/ja/skills/deploy-to-vercel

agentsagentskillsai-assisted-developmentclaude-codeskillsteams