mastra build
コマンドは、Mastraプロジェクトを本番環境用のHonoサーバーにバンドルします。Honoは、型安全なルーティングとミドルウェアのサポートを提供する軽量のWebフレームワークで、MastraエージェントをHTTPエンドポイントとしてデプロイするのに理想的です。
使用方法
mastra build [options]
オプション
--dir <path>
: Mastraプロジェクトを含むディレクトリ(デフォルト:現在のディレクトリ)
高度な使用法
並列処理の制限
CIや、リソースが制限された環境で実行する場合、MASTRA_CONCURRENCY
を設定することで、同時に実行される重いタスクの数を制限できます。
MASTRA_CONCURRENCY=2 mastra build
設定を解除すると、CLIはホストの性能に基づいて並列処理を行います。
テレメトリの無効化
匿名のビルド分析をオプトアウトするには、以下を設定します:
MASTRA_TELEMETRY_DISABLED=1 mastra build
カスタムプロバイダーエンドポイント
ビルド時には、mastra dev
と同じOPENAI_BASE_URL
およびANTHROPIC_BASE_URL
変数が尊重されます。これらはAI SDKによって、プロバイダーを呼び出すワークフローやツールに転送されます。
機能
- Mastraのエントリーファイル(
src/mastra/index.ts
またはsrc/mastra/index.js
)を見つけます .mastra
出力ディレクトリを作成します- 以下の機能を備えたRollupを使用してコードをバンドルします:
- 最適なバンドルサイズのためのツリーシェイキング
- Node.js環境のターゲティング
- デバッグ用のソースマップ生成
例
# Build from current directory
mastra build
# Build from specific directory
mastra build --dir ./my-mastra-project
出力
このコマンドは.mastra
ディレクトリに本番用バンドルを生成します。これには以下が含まれます:
- あなたのMastraエージェントをエンドポイントとして公開するHonoベースのHTTPサーバー
- 本番環境向けに最適化されたJavaScriptファイル
- デバッグ用のソースマップ
- 必要な依存関係
この出力は以下に適しています:
- クラウドサーバー(EC2、Digital Ocean)へのデプロイ
- コンテナ化された環境での実行
- コンテナオーケストレーションシステムでの使用
デプロイヤー
デプロイヤーを使用すると、ビルド出力が対象プラットフォーム向けに自動的に準備されます。例: