デプロイ概要
Mastra では、フルマネージドからセルフホスト、Web フレームワーク統合まで、アプリケーションのニーズに合わせた複数のデプロイ方法を提供しています。本ガイドでは、利用可能なデプロイ手段を理解し、プロジェクトに最適な選択肢を見つけるための手助けをします。
デプロイ方法
ランタイムのサポート
- Node.js
v20.0以上 - Bun
- Deno
- Cloudflare
Mastra Cloud
Mastra Cloud は、GitHub リポジトリに接続し、コードの変更に合わせて自動デプロイを行い、監視ツールも提供するデプロイプラットフォームです。主な機能は次のとおりです:
- GitHub リポジトリ連携
- git push による自動デプロイ
- エージェントのテスト用インターフェース
- 詳細なログとトレース
- プロジェクトごとのカスタムドメイン
Webフレームワークでの利用
MastraはさまざまなWebフレームワークと統合できます。詳しくは、次のガイドをご覧ください。
フレームワークと統合しても、通常はデプロイのための追加設定は不要です。
サーバーでの運用
Mastra は標準の Node.js HTTP サーバーとしてデプロイでき、インフラやデプロイ環境を自在にコントロールできます。
- カスタム API ルートとミドルウェア
- CORS や認証の柔軟な設定
- VM、コンテナ、PaaS へのデプロイに対応
- 既存の Node.js アプリケーションとの統合に最適
サーバーレスプラットフォーム
Mastra は人気のサーバーレスプラットフォーム向けにプラットフォーム別のデプロイヤーを提供しており、最小限の設定でアプリケーションをデプロイできます。
- Cloudflare Workers、Vercel、Netlify へのデプロイ
- プラットフォーム別の最適化
- デプロイを簡素化するプロセス
- プラットフォームによる自動スケーリング
クライアント構成
Mastra アプリケーションをデプロイしたら、クライアントがそれと通信できるように設定する必要があります。Mastra Client SDK は、Mastra サーバーとやり取りするためのシンプルで型安全なインターフェースを提供します。
- 型安全な API 連携
- 認証とリクエスト処理
- リトライとエラー処理
- ストリーミング応答のサポート
デプロイオプションの選択
| オプション | 最適な対象 | 主な利点 |
|---|---|---|
| Mastra Cloud | インフラを気にせず迅速にリリースしたいチーム | フルマネージド、自動スケーリング、組み込みのオブザーバビリティ |
| Framework Deployment | 既に Next.js、Astro などを利用しているチーム | フロントエンドとバックエンドを単一のコードベースで統合し、デプロイを簡素化 |
| Server Deployment | 最大限の制御とカスタマイズが必要なチーム | 完全な制御、カスタムミドルウェア、既存アプリとの統合 |
| Serverless Platforms | 既に Vercel、Netlify、Cloudflare を利用しているチーム | プラットフォーム連携、デプロイの簡素化、自動スケーリング |