Skip to Content

CloudflareDeployer

CloudflareDeployerクラスは、スタンドアロンのMastraアプリケーションをCloudflare Workersにデプロイすることを処理します。設定とデプロイメントを管理し、Cloudflare固有の機能でベースのDeployerクラスを拡張します。

インストール

npm install @mastra/deployer-cloudflare@latest

使用例

src/mastra/index.ts
import { Mastra } from "@mastra/core/mastra"; import { CloudflareDeployer } from "@mastra/deployer-cloudflare"; export const mastra = new Mastra({ // ... deployer: new CloudflareDeployer({ scope: "your-account-id", projectName: "hello-mastra", scope: "", auth: { apiToken: process.env.CLOUDFLARE_API_TOKEN!, apiEmail: "name@email.com" } }) });

利用可能なすべての設定オプションについては、CloudflareDeployer APIリファレンスを参照してください。

手動デプロイ

Cloudflare Wrangler CLIを使用した手動デプロイも可能です。Wrangler CLIをインストールした後、プロジェクトルートから以下を実行してアプリケーションをデプロイします。

Wrangler CLIをインストールした後、Cloudflareアカウントでログインして認証を行います:

npx wrangler login

以下を実行してアプリケーションをビルドし、Cloudflareにデプロイします

npm run build && wrangler deploy --config .mastra/output/wrangler.json

プロジェクトルートからwrangler dev --config .mastra/output/wrangler.jsonを実行して、Mastraアプリケーションをローカルでテストすることもできます。

ビルド出力

CloudflareDeployerを使用したMastraアプリケーションのビルド出力には、プロジェクト内のすべてのエージェント、ツール、ワークフローと、Cloudflareでアプリケーションを実行するために必要なMastra固有のファイルが含まれます。

      • index.mjs
      • wrangler.json
  • package.json

CloudflareDeployerは、以下の設定で.mastra/outputwrangler.json設定ファイルを自動生成します:

{ "name": "hello-mastra", "main": "./index.mjs", "compatibility_date": "2025-04-01", "compatibility_flags": ["nodejs_compat", "nodejs_compat_populate_process_env"], "observability": { "logs": { "enabled": true } }, "vars": { "OPENAI_API_KEY": "...", "CLOUDFLARE_API_TOKEN": "..." } }

次のステップ