Cloudflare

Use @mastra/deployer-cloudflare to deploy your Mastra server to Cloudflare Workers. The deployer bundles your code and generates a wrangler.jsonc file conforming to Cloudflare's wrangler configuration, ready to deploy with no additional configuration.

备注

If you're using a server adapter or web framework, deploy the way you normally would for that framework.

Before you begin

You'll need a Mastra application and a Cloudflare account.

注意

Cloudflare Workers use an ephemeral filesystem, so any storage you configure (including observability storage) must be hosted externally. If you're using LibSQLStore with a file URL, switch to a remotely hosted database.

Installation

Add the @mastra/deployer-cloudflare package to your project:

npm

npm install @mastra/deployer-cloudflare@latest

pnpm

pnpm add @mastra/deployer-cloudflare@latest

Yarn

yarn add @mastra/deployer-cloudflare@latest

Bun

bun add @mastra/deployer-cloudflare@latest

Import CloudflareDeployer and set it as the deployer in your Mastra configuration:

src/mastra/index.ts

import { Mastra } from '@mastra/core'
import { CloudflareDeployer } from '@mastra/deployer-cloudflare'

export const mastra = new Mastra({
  deployer: new CloudflareDeployer({
    name: 'your-project-name',
    vars: {
      NODE_ENV: 'production',
    },
  }),
})

To test your Cloudflare Worker locally, also install the wrangler CLI:

npm

npm install -D wrangler

pnpm

pnpm add -D wrangler

Yarn

yarn add --dev wrangler

Bun

bun add --dev wrangler

Usage

After setting up your project, push it to your remote Git provider of choice (e.g. GitHub).

1. Connect your repository to Cloudflare. On the "Workers & Pages" dashboard, select Create application and choose your Git provider in the next step. Continue with the setup process and select the repository you want to deploy.

   备注

   Remember to set your environment variables needed to run your application (e.g. your model provider API key). You can upload secrets from your .env file using npx wrangler secret bulk .env. See Secrets for details.

2. Once you're ready, click the Deploy button and wait for the first deployment to complete.

3. Try out your newly deployed function by going to https://<your-project-name>.<slug>.workers.dev/api/agents. You should get a JSON response listing all available agents.

   Since the Mastra server prefixes every API endpoint with /api, you have to add it to your URLs when making requests.

4. You can now call your Mastra endpoints over HTTP.

   备注

   Set up authentication before exposing your endpoints publicly.