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/outputにwrangler.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": "..."
  }
}

次のステップ

Mastra Client SDK