Vercel ステータスガイド
GIIP プラットフォームで Vercel のデプロイ状態を確認し、デプロイ履歴をモニタリングする方法を説明します。
📋 概要
Vercel ステータスページは、GIIP に登録された Vercel 設定と、各設定の最新デプロイ状態を一目で確認する画面です。このページを開くと、現在選択中のプロジェクト（csn）の Vercel 管理一覧（/project/[csn]/vercel）へ自動的に移動します。プロジェクトが選択されていない場合は既定のプロジェクトへ移動します。
🔍 主な構成要素
1. Vercel 設定カード一覧
登録された各 Vercel 設定がカード形式で表示されます。カードには設定名（vcConfigName）、連携された Vercel プロジェクト名（vcVercelProjectName）、説明が表示されます。無効化された設定は薄く表示され、無効（Inactive） バッジが付きます。
2. 最新デプロイ状態バッジ
各カードには、直近のデプロイの状態が色付きバッジで表示されます。
READY（緑）: デプロイ完了BUILDING（青）: ビルド進行中ERROR（赤）: デプロイ失敗CANCELED（黄）: デプロイ取消QUEUED（紫）: 待機中
デプロイ URL がある場合はクリックすると、実際にデプロイされたサイトを新しいタブで開けます。カード下部には総デプロイ件数（deploymentCount）と最終同期日（vcLastSyncAt）が表示されます。
3. カードアクションボタン
各カードでは次の操作が行えます。
- デプロイを見る: 当該設定のデプロイ履歴詳細ページへ移動します。
- 同期: Vercel から最新のデプロイ情報を取得して更新します。
- 編集: 設定を編集します。
- 削除: 設定を削除します（削除前に確認ダイアログが表示されます）。
4. デプロイ履歴テーブル
設定カードで［デプロイを見る］を押すと、当該設定のデプロイ一覧がテーブルで表示されます。列は URL、状態（State）、作成時刻（Created）、作成者（Creator）、対象（Target）です。上部で状態フィルター（すべて／READY／BUILDING／ERROR／CANCELED／QUEUED）と表示件数（10／20／50）を調整できます。
🛠️ 活用のヒント
- 新しい設定を追加: 右上の［設定を追加］ボタンで新しい Vercel 設定を登録できます。
- 最新化: デプロイ状態は自動でリアルタイム更新されません。最新の状態が必要な場合は、カードまたは詳細ページの［同期］ボタンを押して Vercel からデータを取得し直してください。
- プロジェクト切替: 上部でプロジェクトを変更すると、そのプロジェクトの Vercel 一覧へ自動的に切り替わります。
💡 注意事項
- このページ自体はリダイレクト専用です。「Vercel 管理ページへ移動中...」というメッセージが一瞬表示された後、プロジェクトの Vercel 一覧へ移動します。
- デプロイ一覧が空の場合は、まだ同期が実行されていないか、Vercel トークンが無効である可能性があります。
API 参照
この機能の API 詳細仕様は別ガイドを参照してください。
トラブルシューティング
| 症状 | 原因 | 解決 |
|---|---|---|
| ページが「移動中...」のまま止まる | セッションに csn がない、またはログインセッションが期限切れ | 再ログインするかプロジェクトを選択してから再アクセスします。 |
| 設定カードが 1 つも表示されない | 現在のプロジェクトに登録済みの Vercel 設定がない | ［設定を追加］ボタンで新しい Vercel 設定を登録します。 |
| 最新デプロイ状態が表示されない | まだ同期されておらずデプロイ履歴がない | カードの［同期］ボタンを押して Vercel からデータを取得します。 |
デプロイ状態が ERROR と表示される | Vercel のビルドが失敗した | デプロイ URL または Vercel ダッシュボードでビルドログを確認します。 |
| 同期が失敗する | Vercel トークンが期限切れまたは不正 | 設定の［編集］で有効なトークンに更新してから再同期します。 |
バージョン: 1.0
最終更新: 2026-07-22
ソースファイル: giipv3/public/help/vercel-status.ja.md