サーバーレスデプロイメント
このガイドでは、プラットフォーム固有のデプロイヤーを使用して、MastraをCloudflare Workers、Vercel、およびNetlifyにデプロイする方法について説明します
セルフホスト型Node.jsサーバーのデプロイメントについては、Mastraサーバーの作成ガイドを参照してください。
前提条件
始める前に、以下のものを用意してください:
- Node.js がインストールされていること(バージョン18以上を推奨)
- プラットフォーム固有のデプロイヤーを使用する場合:
- 選択したプラットフォームのアカウント
- 必要なAPIキーまたは認証情報
サーバーレスプラットフォームデプロイヤー
プラットフォーム固有のデプロイヤーは、以下の設定とデプロイを処理します:
- Cloudflare Workers
- Vercel
- Netlify
- Mastra Cloud (ベータ)。早期アクセスのためにクラウドウェイトリスト に参加できます。
デプロイヤーのインストール
# For Cloudflare
npm install @mastra/deployer-cloudflare@latest
# For Vercel
npm install @mastra/deployer-vercel@latest
# For Netlify
npm install @mastra/deployer-netlify@latest
デプロイヤーの設定
エントリーファイルでデプロイヤーを設定します:
import { Mastra, createLogger } from "@mastra/core";
import { CloudflareDeployer } from "@mastra/deployer-cloudflare";
export const mastra = new Mastra({
agents: {
/* your agents here */
},
logger: createLogger({ name: "MyApp", level: "debug" }),
deployer: new CloudflareDeployer({
scope: "your-cloudflare-scope",
projectName: "your-project-name",
// See complete configuration options in the reference docs
}),
});
デプロイヤーの設定
各デプロイヤーには特定の設定オプションがあります。以下は基本的な例ですが、完全な詳細についてはリファレンスドキュメントを参照してください。
Cloudflare デプロイヤー
new CloudflareDeployer({
scope: "your-cloudflare-account-id",
projectName: "your-project-name",
// For complete configuration options, see the reference documentation
});
Vercel デプロイヤー
new VercelDeployer({
teamSlug: "your-vercel-team-slug",
projectName: "your-project-name",
token: "your-vercel-token",
// For complete configuration options, see the reference documentation
});
Netlify デプロイヤー
new NetlifyDeployer({
scope: "your-netlify-team-slug",
projectName: "your-project-name",
token: "your-netlify-token",
});
環境変数
必要な変数:
- プラットフォームデプロイヤー変数(プラットフォームデプロイヤーを使用する場合):
- プラットフォームの認証情報
- エージェントAPIキー:
OPENAI_API_KEY
ANTHROPIC_API_KEY
- サーバー設定(ユニバーサルデプロイメント用):
PORT
: HTTPサーバーポート(デフォルト:3000)HOST
: サーバーホスト(デフォルト:0.0.0.0)
Mastraプロジェクトのビルド
ターゲットプラットフォーム向けにMastraプロジェクトをビルドするには、次のコマンドを実行します:
npx mastra build
Deployerを使用すると、ビルド出力は自動的にターゲットプラットフォーム用に準備されます。
その後、プラットフォーム(Vercel、netlify、cloudfare など)のCLI/UIを通じて、ビルド出力 .mastra/output
をデプロイできます。