Mastraエージェント、どのクラウドにデプロイする？

【出版記念！ランチイベント】MastraによるAIエージェント開発・運用 実践入門
https://kddi-agile.connpass.com/event/395678/

Transcript

1. Mastraエージェント、 どこにデプロイする？ みのるん　@minorun365
2. 御田 稔（みのるん） KDDIアジャイル開発センター株式会社 テックエバンジェリスト AWS AI Hero / AWS Samurai Qiita 2025 Top Contributor 2
3. 作ったエージェントを 他の人に使ってもらうには、 2つの仕事が必要
4. 「サーバー」って2種類あんねん エージェントをAPIサーバーにして、デプロイする必要がある ❶ APIにする仕事 アプリとしてのサーバー HTTPリクエストを受け付ける 「プログラム」そのもの GET /api → 200 OK 例：Hono、Express ❷ 動かす場所を選ぶ仕事 インフラとしてのサーバー プログラムを動かす「場所」 例：Amazon EC2、クラウド 4
5. ❶のAPI化は、実はもう終わっている Mastraが内蔵するHonoベースのHTTPサーバーが、 登録したエージェントを自動でREST APIにしてくれます あなたのコード エージェント ワークフロー ツール 登録 内蔵サーバー HonoベースのHTTPサーバー REST APIが⾃動で⽣える GET /api/agents POST /api/agents/ :id/generate … mastra dev 開発サーバー起動（:4111） Mastra Studioもここで動く mastra build .mastra/output/ に 単独サーバーとして出⼒ → Node直実⾏もDocker化も⾃由 5
6. 残る仕事は、動かす場所選び ここからが今日の本題です ❶ APIにする仕事 アプリとしてのサーバー HTTPリクエストを受け付ける 「プログラム」そのもの GET /api → 200 OK 例：Hono、Express ❷ 動かす場所を選ぶ仕事 インフラとしてのサーバー プログラムを動かす「場所」 例：Amazon EC2、クラウド 6
7. 今日紹介する主なデプロイ先は6つ ① Mastra Server まず試してみたい ② Vercel Next.jsと⼀体で運びたい ③ Cloudflare Workers エッジで低レイテンシに配信 ④ Bedrock AgentCore AWSと統合したい ⑤ Container Apps Azureと統合したい ⑥ Cloud Run Google Cloudと統合したい 7
8. やり方で見ると4パターンに整理できる Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel（Next.js統合） 専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run 8
9. ここから6つのデプロイ先を 選定理由つきで紹介します
10. ① Mastra Server
11. Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel（Next.js統合） 専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run
12. ① 公式マネージド「Mastra Server」 内蔵サーバーを丸ごと預けて動かせる、公式のPaaS。 だからその名も "Mastra Server" プラン 料金 CPU時間 データ転送 Starter 無料 24時間/月 10GB/月 Teams 月額250ドル 250時間/月 100GB/月 Enterprise カスタム カスタム カスタム 旧称は「Mastra Cloud」 。2026年4月に改名したばかり 12
13. ① デプロイは実質1コマンド npx mastra server deploy --project my-app --yes Mastraプロジェクト APIトークンと組織IDを⽤意 mastra server deploy コンテナ化もホストもおまかせ 公開URLが発⾏される *.server.mastra.cloud APIキーは mastra server env set でサーバー側に設定 GitHub Actionsと組ませればpush連動のCI/CDも作れる 13
14. ② Vercel
15. Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel（Next.js統合） 専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run
16. ② Vercel、デプロイ方式は2択 今回はコレ Next.js統合 アプリの⼀部としてMastraを同居 git pushだけでデプロイ完了 フロントとバックを⼀体で運⽤ ✓ 第12章のフルスタック構成そのまま Mastraデプロイヤー @mastra/deployer-vercel を使い 単独のAPIサーバーとしてデプロイ フロントが別リポジトリの構成向け こちらも公式サポートあり エージェント専用サービスは無いが、実行基盤のFluid Compute 自体がAI向けに進化中。長めの関数実行にも対応が進む 16
17. ② デプロイはgit pushするだけ GitHubリポジトリと連携 初回だけWeb画⾯でImport git push pushのたびに⾃動ビルド＆デプロイ HTTPSで⾃動公開 *.vercel.app mainへpushするたびに自動デプロイ。プレビューURLも発行 DBや画像は外部サービスへの切り替えが必要。詳しくは最後に フルスタックの通し手順は第12章で 17
18. ③ Cloudflare
19. Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel（Next.js統合） 専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run
20. ③ Agents SDKランタイムじゃないの？ 今回はコレ Workers ＋ 専⽤デプロイヤー V8 Isolatesでコールドスタート ほぼゼロのエッジ実⾏環境 Mastraのコードをそのまま載せられる ✓ @mastra/deployer-cloudflare Agents SDKランタイム Durable Objectsベースの公式 エージェント基盤。永続状態や ⻑時間実⾏を強化中（Project Think） △ 専⽤SDKで書く⼈向け。Mastraとは別路線 Agents SDKランタイムは "Cloudflare版のエージェント基盤"。 Mastraで書いたコードの載せ先としては、素直にWorkersへ 20
21. ③ 専用デプロイヤーでWorkersへ npx mastra build デプロイヤーがWorkers⽤に変換 npx wrangler deploy APIキーはwrangler secretで 世界中のエッジで公開 *.workers.dev コールドスタートほぼゼロ。月5ドルに1,000万リクエスト込み スクリプト10MB、メモリ128MBの制約には注意 推論までCloudflareで完結させるならWorkers AIという手も 21
22. ④ AWS
23. Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel（Next.js統合） 専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run
24. ④ AWS、なぜLambdaやECSじゃないのか Lambda 定番のサーバーレス関数。 ただし実⾏は最⼤15分 ✗ ⻑時間タスクに不向き ECS / Fargate コンテナ常駐が前提。 LLMの応答待ちの間も 課⾦され続ける ✗ アイドル課⾦と運⽤が重い 今回はコレ AgentCore エージェント専⽤ランタイム （2025年10⽉GA） CPUは使った秒数だけ課⾦ ✓ 応答待ち中のCPU課⾦はゼロ エージェントは「LLMの応答待ち」が異様に長いワークロード。 課金モデルが専用設計のAgentCoreと相性抜群 24
25. ④ AgentCore CLIで面倒ごと全部おまかせ agentcore create テンプレ⽣成、Mastraに差し替え agentcore deploy ECR、IAM、ランタイム⾃動作成 agentcore invoke CLIからそのまま動作確認 セッションごとにマイクロVM分離、最大8時間の実行にも対応 東京リージョン対応済み。コンテナビルドもクラウド側で実行 詳しくは拙著「AgentCore実践入門」もどうぞ 25
26. ⑤ Azure
27. Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel（Next.js統合） 専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run
28. ⑤ AzureはContainer Appsが好相性 Foundry Agent Service AgentCore相当の「Hosted agents」で コンテナ持ち込みに対応。まずは Pythonと.NETからサポート開始 △ TypeScript対応は今後に期待 今回はコレ Container Apps サーバーレスコンテナ実⾏基盤。 Cloud Runに近い使い勝⼿で ⾔語を問わず何でも動かせる ✓ mastra buildの出⼒をそのまま実⾏ AgentCore相当のHosted agentsはPython/.NETに対応。 TypeScript対応に期待しつつ、今はContainer Appsへ 28
29. ⑤ Container Appsへはaz CLIでデプロイ az acr build イメージビルドはクラウド側で az containerapp create APIキーはシークレット登録 HTTPSで⾃動公開 *.azurecontainerapps.io ゼロスケール中は課金なし。無料枠も月200万リクエスト アイドルタイムアウト240秒に注意。SSEが切れるなら Premium Ingressで最大30分まで延ばせる 29
30. ⑥ Google Cloud
31. Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel（Next.js統合） 専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run
32. ⑥ TypeScript勢はCloud Runが王道 Agent Runtime AgentCore相当の専⽤基盤 （旧Vertex AI  Agent Engine） △ まずはPythonに対応 GKE / App Engine 実績豊富な汎⽤の コンテナ実⾏基盤。 フル機能で本格運⽤向け △ 今回の規模にはやや⼤きい 今回はコレ Cloud Run サーバーレスコンテナの定番。 デプロイ1コマンド、 タイムアウト最⼤60分 ✓ 無料枠も充実 AgentCore相当のAgent Runtimeは、まずPythonに対応。 TypeScriptのMastraは、定番のCloud Runで快適に動く 32
33. ⑥ Cloud Runなら1コマンドで完結 Dockerfileを書く 中でmastra buildを実⾏ gcloud run deploy --source . ビルドもプッシュも全部⾃動 HTTPSで⾃動公開 *.run.app タイムアウト最大60分、メモリ最大32GB。長時間実行に有利 毎月リセットされる無料枠が充実。個人開発に優しい SSEもWebSocketもgRPCもストリーミング対応 33
34. 最後に1つだけ、 どのデプロイ先でも共通の注意点
35. ステートレス環境の「データ消える」問題 今日の6つは全部サーバーレスかコンテナ。 再デプロイするとファイルシステムは消えます libSQLファイルのままだと、エージェントの記憶や ワークフローの実行状態が消える Tursoや @mastra/pg など外部DBへ切り替えよう クラウド純正のAgentCoreメモリーやD1もアリ 35
36. 例えば第12章のVercel構成では DB3つはTursoへ、生成画像はVercel Blobへ切り替えました ローカル開発 本番（Vercel＋外部サービス） 認証DB auth.db Turso（外部のクラウドlibSQL） ストレージDB mastra.db Turso（外部のクラウドlibSQL） ベクトルDB local.db Turso（外部のクラウドlibSQL） ⽣成画像 public/ Vercel Blob（Vercel純正ストレージ） 環境変数の有無でフォールバック。ローカルはそのまま動く 36
37. 選び方はこの1枚でOK とにかくまず試したい Yes Mastra Server（公式） No Next.jsアプリと⼀体で運びたい Yes Vercel No エッジで低レイテンシに動かしたい Yes Cloudflare Workers No 会社の標準クラウドに載せたい AWSなら AgentCore Azureなら Container Apps Google Cloudなら Cloud Run 37
38. 詳しい手順は、ぜんぶ本に 第13章に5つのデプロイ先の 通し手順を載せています。 コードはGitHubからコピペOK まずは無料のMastra Serverへ 1コマンドデプロイから 試してみてください！ 38