Deploy

Deploy (Cloud Run デプロイ)

核心コンセプト: "品質保証付きワンコマンドデプロイ"

gcloud run deploy --source . を活用した軽量デプロイスキル。 Terraform不要、gcloud CLI のみで Cloud Run にデプロイする。

核心原則

1. 品質ファースト: デプロイ前に品質ゲート（Critical checks）を通過必須
2. シークレット安全管理: API キーは Secret Manager から取得、平文コマンド禁止
3. 検証可能: デプロイ後にヘルスチェックで動作確認
4. 追跡可能: 全デプロイのリビジョン・Git Commit・ステータスを自動記録

デプロイ設定

以下のデフォルト値を使用する。オーバーライドする場合はオプションで指定。

環境変数（Cloud Run に設定）

実行プロトコル

Phase 1: Pre-flight (品質ゲート)

1. git status 確認 — uncommitted changes の警告
2. make q.critical 実行 — Critical checks 全通過必須
   - format.check, analyze, architecture, ui-flow, codegen.check, test, build
3. Standalone バンドル検証:
   a. next.config.ts に serverExternalPackages: ['sucrase'] が設定されているか確認
   b. npm run build を実行し .next/standalone/ を生成
   c. .next/standalone/node_modules/sucrase が存在するか確認
   d. sucrase の transform() が standalone 環境で動作するか確認
   失敗時 → デプロイ中止（sucrase 未バンドルだと sandbox/serve でトランスパイル不可）
4. 失敗時 → デプロイ中止、修正を促す

--skip-checks 指定時: Phase 1 をスキップ（緊急時のみ）

Phase 2: デプロイ実行

1. gcloud run deploy 実行:
   gcloud run deploy <service> \
     --source . \
     --region <region> \
     --allow-unauthenticated \
     --project <project>

2. 環境変数の設定:
   - Secret Manager が利用可能な場合:
     --set-secrets "GEMINI_API_KEY=gemini-api-key:latest"
   - Secret Manager 未設定の場合:
     --set-env-vars "GEMINI_API_KEY=$(gcloud secrets versions access latest --secret=gemini-api-key --project=<project>)"
   - フォールバック (Secret Manager なし):
     ユーザーに GEMINI_API_KEY の指定を求める

Phase 3: Post-flight (デプロイ検証)

1. gcloud run revisions list で最新リビジョン名を取得
2. gcloud run services describe でサービス URL を取得
3. curl でヘルスチェック (HTTP 200 確認)

Phase 4: リビジョン記録

1. デプロイ成功時のみ記録 (失敗時はスキップ)
2. docs/deployments/DEPLOY-LOG.md にエントリ追記:
   - 連番, 日時, リビジョン名, Git Commit (hash + message), ステータス, 品質ゲート, URL
3. 最新のデプロイが最上部に表示される (降順)

記録フォーマット:

| #   | 日時             | リビジョン                | Git Commit               | ステータス | 品質ゲート | URL         |
| --- | ---------------- | ------------------------- | ------------------------ | :--------: | :--------: | ----------- |
| 3   | 2026-02-15 15:00 | `hackathon-project-00003-xyz` | `abc1234 feat: add quiz` |     OK     |   PASSED   | https://... |
| 2   | 2026-02-15 14:00 | `hackathon-project-00002-def` | `def5678 fix: streaming` |     OK     |  SKIPPED   | https://... |

制約事項

1. 平文キー禁止: --set-env-vars GEMINI_API_KEY=AIza... のような平文指定は禁止。Secret Manager を使用する
2. 未コミット変更警告: uncommitted changes がある場合は警告を表示（デプロイは続行可能）
3. gcloud CLI 必須: gcloud コマンドがインストール・認証済みであること
4. プロジェクト権限: Cloud Run Admin, Cloud Build Editor, Storage Admin 権限が必要
5. Standalone バンドル必須: next.config.ts の serverExternalPackages: ['sucrase'] は削除禁止。sucrase は API route (/api/sandbox/serve) でサーバーサイドのJSX/TypeScriptトランスパイルに使用しており、webpack バンドルでは正常動作しない場合がある。NFT (Node File Tracing) が .next/standalone/node_modules/ に自動コピーする

出力例

# Deploy 実行結果

> **実行時間**: 2026-02-15 14:30:00 JST

## Pre-flight

| チェック        | 結果 |
| --------------- | :--: |
| Git Status      |  OK  |
| Format          |  OK  |
| Lint + Security |  OK  |
| Architecture    |  OK  |
| Tests           |  OK  |
| Build           |  OK  |

## デプロイ

| 項目           | 値                                       |
| -------------- | ---------------------------------------- |
| サービス       | hackathon-project                            |
| リージョン     | asia-northeast1                          |
| プロジェクト   | gemini-3-tokyo-hackathon                      |
| URL            | https://hackathon-project-xxxxx-an.a.run.app |
| ヘルスチェック | HTTP 200 OK                              |

## ステータス: DEPLOYED

使用例

# 基本デプロイ（品質ゲート付き）
/deploy

# 品質チェック省略（緊急時）
/deploy --skip-checks

# プロジェクト指定
/deploy --project my-other-project

# リージョン指定
/deploy --region us-central1

Makefile 連携

# CLI から直接デプロイ
make deploy

# dry-run（デプロイせずにビルドのみ確認）
make deploy.dry-run

変更履歴