デプロイの概要
Mastra アプリケーションは、Node.js と互換性のある任意の環境にデプロイできます。Mastra サーバーをデプロイする、既存の Web フレームワークと統合する、クラウド Provider にデプロイする、または可観測性、Studio、サーバーデプロイのために Mastra platform を利用できます。
Runtime のサポートRuntime のサポートへの直接リンク
Mastra は次の Runtime 環境で動作します。
- Node.js
v22.13.0以降 - Bun
- Deno
- Cloudflare
デプロイ方法デプロイ方法への直接リンク
Mastra サーバーMastra サーバーへの直接リンク
Mastra は、単独でデプロイできる Hono ベースのサーバーを提供します。mastra build コマンドでアプリケーションをビルドし、その出力を任意の VM、コンテナ、PaaS プラットフォームにデプロイします。
インフラストラクチャを完全に制御する必要がある場合、長時間実行するプロセスが必要な場合、または WebSocket 接続を使用する場合は、この方法を選択してください。詳しくは、Mastra サーバーデプロイガイドを参照してください。
MonorepoMonorepoへの直接リンク
スタンドアロンでのデプロイと同じ方法で、monorepo 構成の一部として Mastra サーバーをデプロイします。
詳しくは、monorepo でのデプロイを参照してください。
Mastra platformMastra platformへの直接リンク
Mastra platform は、Mastra フレームワークで構築した AI アプリケーションをデプロイ、監視、管理するための3つの製品を提供します。
- Observability: Mastra のプロジェクトやデプロイ全体の Trace、ログ、メトリクスを検索できる、独立したホステッド製品
- Studio: Agent のテスト、Workflow の実行、Trace の調査を行える、ホステッド型のビジュアル環境
- Server: Mastra アプリケーションを API サーバーとして実行する本番環境向けデプロイ先
詳しくは、Mastra platform の概要を参照してください。
クラウド Providerクラウド Providerへの直接リンク
Mastra アプリケーションは、クラウド Provider やサーバーレスプラットフォームにデプロイできます。Mastra には、ビルドとデプロイのプロセスを自動化するための Vercel、Netlify、Cloudflare 向け組み込み Deployer がオプションで用意されています。
自動スケーリングを利用したい場合、インフラストラクチャの管理を最小限に抑えたい場合、またはこれらのプラットフォームのいずれかをすでに使用している場合は、この方法を選択してください。
SandboxSandboxへの直接リンク
Mastra サーバーを一時的な Workspace Sandbox（Vercel Sandbox や E2B など）にデプロイし、数秒で公開 URL を取得できます。
即時プレビュー、CI パイプラインからのデプロイ、Agent が構築したアプリの検証、ユーザーごとの信頼できないインスタンスの実行には、この方法を使用します。詳しくは、Sandbox デプロイガイドを参照してください。
Web フレームワークWeb フレームワークへの直接リンク
Mastra を Web フレームワークと統合すると、そのフレームワークの標準的なデプロイプロセスを使用して、アプリケーションと一緒にデプロイされます。以下のガイドでは、デプロイ時に必要となるフレームワーク固有の設定について説明します。
既存の Next.js または Astro アプリケーションに Mastra を追加する場合は、次のガイドを使用してください。
Workflow runnerWorkflow runnerへの直接リンク
Mastra Workflow は、デフォルトでは組み込みの実行エンジンを使用して実行されます。マネージドインフラストラクチャを必要とする本番ワークロードでは、Workflow を Inngest のような専用プラットフォームにデプロイすることもできます。このようなプラットフォームは、ステップのメモ化、自動再試行、リアルタイム監視を提供します。
実行方法については Workflow runner ガイドを、セットアップ手順については Inngest デプロイガイドを参照してください。
WorkerWorkerへの直接リンク
本番環境へのデプロイでは、Mastra は Workflow のオーケストレーション、cron スケジューリング、バックグラウンドでの Tool 実行を、API サーバーとは別の専用 Worker プロセスで実行できます。これにより、それぞれを個別にスケールし、障害を分離できます。詳しくは、Workerを参照してください。