# ADKの便利で実践的な使い方
DockerfileもK8sマニフェストも書かずにエージェントをデプロイしたい?☁️ `adk deploy cloud_run`コマンド一発で、コンテナサーバレス環境にエージェントが立ち上がります。Dev UIも付けられて、開発と運用がシームレスに!
## 📌 タイトル
Cloud Run — コマンド一発のコンテナサーバレスデプロイ
## 🔗 URL
## 🧩 概要
ADKのCloud Runデプロイは、`adk deploy cloud_run`コマンドでDockerfileやマニフェストの手動作成なしにエージェントをサーバレス環境にデプロイします。`--with_ui`でDev UIを同梱、`--session_service_uri=agentengine://
`でマネージドセッションと統合でき、オートスケーリングなWebバックエンドとして即座に利用可能です。
## 🛠 使い方
基本のデプロイコマンド:
```bash
adk deploy cloud_run \
--project=$GOOGLE_CLOUD_PROJECT \
--region=$GOOGLE_CLOUD_LOCATION \
$AGENT_PATH
```
主要オプション:
- `--with_ui`: ADK開発インターフェースをAPIサーバーと一緒にデプロイ
- `--session_service_uri`: セッションサービスのURIを指定(Agent Runtimeのマネージドセッションは `agentengine://`)
- `--service_name`: Cloud Runサービス名をカスタマイズ
- `--port`: コンテナのリスニングポート指定(デフォルト8000)
代替方法として、`gcloud run deploy`でカスタムDockerfileを使い、既存のFastAPIアプリにエージェントを組み込むことも可能です。
## 🏗 実践的な使い方
- **プロトタイプの公開**: `--with_ui`付きでデプロイし、チームにDev UI経由でエージェントを試してもらう
- **既存Webアプリとの統合**: `gcloud run deploy`でカスタムFastAPIアプリにエージェント機能を追加
- **マネージドセッション**: `--session_service_uri=agentengine://`でAgent Runtimeのセッション管理を利用し、ステートフルな会話を実現
- **オートスケーリング**: トラフィックに応じた自動スケーリングでWebバックエンドとして安定運用
- **認証制御**: デプロイ時にunauthenticatedアクセスの可否を選択。非公開APIには`gcloud auth print-identity-token`でアクセス
## 💡 ユースケース
- 社内ツールとしてエージェントをDev UI付きで素早く展開
- 既存のFastAPI/Flaskアプリにエージェント機能を追加
- Slackボットやチャットアプリのバックエンドとしてサーバレスで運用
- Agent Runtimeのマネージドセッションを活用したステートフルなチャットサービス
## ⚠️ 注意点
- デプロイ時にunauthenticatedアクセスを許可するか確認されます。公開APIの場合のみ'y'を選択してください
- Cloud Runのコールドスタートを考慮し、レイテンシが重要な場合は最小インスタンス数の設定を検討してください
- `--with_ui`はあくまで開発用です。本番環境では適切な認証を設定してください
- デフォルトポートは8000です。既存サービスと競合する場合は`--port`で変更してください
## ✨
Dockerfile不要、マニフェスト不要。コマンド一発でサーバレスエージェントを世界に公開。Cloud Runデプロイの手軽さをぜひ体験してください!⚡
#ADK# #AIAgent#