Share
Embed
Mastraエージェント、どのクラウドにデプロイする?
【出版記念!ランチイベント】MastraによるAIエージェント開発・運用 実践入門
https://kddi-agile.connpass.com/event/395678/
Transcript
38 slides
-
御田 稔(みのるん) KDDIアジャイル開発センター株式会社 テックエバンジェリスト AWS AI Hero / AWS Samurai
Qiita 2025 Top Contributor 2 -
「サーバー」って2種類あんねん エージェントをAPIサーバーにして、デプロイする必要がある ❶ APIにする仕事 アプリとしてのサーバー HTTPリクエストを受け付ける 「プログラム」そのもの GET /api →
200 OK 例:Hono、Express ❷ 動かす場所を選ぶ仕事 インフラとしてのサーバー プログラムを動かす「場所」 例:Amazon EC2、クラウド 4 -
❶の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 -
残る仕事は、動かす場所選び ここからが今日の本題です ❶ APIにする仕事 アプリとしてのサーバー HTTPリクエストを受け付ける 「プログラム」そのもの GET /api →
200 OK 例:Hono、Express ❷ 動かす場所を選ぶ仕事 インフラとしてのサーバー プログラムを動かす「場所」 例:Amazon EC2、クラウド 6 -
今日紹介する主なデプロイ先は6つ ① Mastra Server まず試してみたい ② Vercel Next.jsと⼀体で運びたい ③ Cloudflare
Workers エッジで低レイテンシに配信 ④ Bedrock AgentCore AWSと統合したい ⑤ Container Apps Azureと統合したい ⑥ Cloud Run Google Cloudと統合したい 7 -
やり方で見ると4パターンに整理できる Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ②
Vercel(Next.js統合) 専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run 8 -
Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel(Next.js統合)
専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run -
① 公式マネージド「Mastra Server」 内蔵サーバーを丸ごと預けて動かせる、公式のPaaS。 だからその名も "Mastra Server" プラン 料金 CPU時間
データ転送 Starter 無料 24時間/月 10GB/月 Teams 月額250ドル 250時間/月 100GB/月 Enterprise カスタム カスタム カスタム 旧称は「Mastra Cloud」 。2026年4月に改名したばかり 12 -
① デプロイは実質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 -
Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel(Next.js統合)
専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run -
② Vercel、デプロイ方式は2択 今回はコレ Next.js統合 アプリの⼀部としてMastraを同居 git pushだけでデプロイ完了 フロントとバックを⼀体で運⽤ ✓ 第12章のフルスタック構成そのまま
Mastraデプロイヤー @mastra/deployer-vercel を使い 単独のAPIサーバーとしてデプロイ フロントが別リポジトリの構成向け こちらも公式サポートあり エージェント専用サービスは無いが、実行基盤のFluid Compute 自体がAI向けに進化中。長めの関数実行にも対応が進む 16 -
② デプロイはgit pushするだけ GitHubリポジトリと連携 初回だけWeb画⾯でImport git push pushのたびに⾃動ビルド&デプロイ HTTPSで⾃動公開 *.vercel.app
mainへpushするたびに自動デプロイ。プレビューURLも発行 DBや画像は外部サービスへの切り替えが必要。詳しくは最後に フルスタックの通し手順は第12章で 17 -
Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel(Next.js統合)
専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run -
③ Agents SDKランタイムじゃないの? 今回はコレ Workers + 専⽤デプロイヤー V8 Isolatesでコールドスタート ほぼゼロのエッジ実⾏環境
Mastraのコードをそのまま載せられる ✓ @mastra/deployer-cloudflare Agents SDKランタイム Durable Objectsベースの公式 エージェント基盤。永続状態や ⻑時間実⾏を強化中(Project Think) △ 専⽤SDKで書く⼈向け。Mastraとは別路線 Agents SDKランタイムは "Cloudflare版のエージェント基盤"。 Mastraで書いたコードの載せ先としては、素直にWorkersへ 20 -
③ 専用デプロイヤーでWorkersへ npx mastra build デプロイヤーがWorkers⽤に変換 npx wrangler deploy APIキーはwrangler
secretで 世界中のエッジで公開 *.workers.dev コールドスタートほぼゼロ。月5ドルに1,000万リクエスト込み スクリプト10MB、メモリ128MBの制約には注意 推論までCloudflareで完結させるならWorkers AIという手も 21 -
Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel(Next.js統合)
専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run -
④ AWS、なぜLambdaやECSじゃないのか Lambda 定番のサーバーレス関数。 ただし実⾏は最⼤15分 ✗ ⻑時間タスクに不向き ECS / Fargate
コンテナ常駐が前提。 LLMの応答待ちの間も 課⾦され続ける ✗ アイドル課⾦と運⽤が重い 今回はコレ AgentCore エージェント専⽤ランタイム (2025年10⽉GA) CPUは使った秒数だけ課⾦ ✓ 応答待ち中のCPU課⾦はゼロ エージェントは「LLMの応答待ち」が異様に長いワークロード。 課金モデルが専用設計のAgentCoreと相性抜群 24 -
④ AgentCore CLIで面倒ごと全部おまかせ agentcore create テンプレ⽣成、Mastraに差し替え agentcore deploy ECR、IAM、ランタイム⾃動作成 agentcore
invoke CLIからそのまま動作確認 セッションごとにマイクロVM分離、最大8時間の実行にも対応 東京リージョン対応済み。コンテナビルドもクラウド側で実行 詳しくは拙著「AgentCore実践入門」もどうぞ 25 -
Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel(Next.js統合)
専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run -
⑤ 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 -
⑤ Container Appsへはaz CLIでデプロイ az acr build イメージビルドはクラウド側で az containerapp
create APIキーはシークレット登録 HTTPSで⾃動公開 *.azurecontainerapps.io ゼロスケール中は課金なし。無料枠も月200万リクエスト アイドルタイムアウト240秒に注意。SSEが切れるなら Premium Ingressで最大30分まで延ばせる 29 -
Mastra CLI CLIから直接デプロイ ① Mastra Server フレームワーク組み込み Next.jsアプリの⼀部として ② Vercel(Next.js統合)
専⽤デプロイヤー 設定を⾃動⽣成 ③ Cloudflare Workers コンテナ mastra buildの出⼒をDocker化 ④ AgentCore ⑤ Container Apps ⑥ Cloud Run -
⑥ 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 -
⑥ Cloud Runなら1コマンドで完結 Dockerfileを書く 中でmastra buildを実⾏ gcloud run deploy --source
. ビルドもプッシュも全部⾃動 HTTPSで⾃動公開 *.run.app タイムアウト最大60分、メモリ最大32GB。長時間実行に有利 毎月リセットされる無料枠が充実。個人開発に優しい SSEもWebSocketもgRPCもストリーミング対応 33 -
例えば第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 -
選び方はこの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