> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ja/llms.txt

# Mastra を Cloudflare にデプロイする

`@mastra/deployer-cloudflare` を使用して、Mastra サーバーを Cloudflare Workers にデプロイします。Deployer はコードをバンドルし、Cloudflare の [wrangler 設定](https://developers.cloudflare.com/workers/wrangler/configuration/)に準拠した `wrangler.jsonc` ファイルを生成するため、追加設定なしでデプロイできます。

> **情報:** [Server Adapter](https://mastra.zisheng.pro/ja/docs/server/server-adapters) または [Web フレームワーク](https://mastra.zisheng.pro/ja/docs/deployment/web-framework)を使用している場合は、そのフレームワークの通常の方法でデプロイしてください。

## 始める前に

[Mastra アプリケーション](https://mastra.zisheng.pro/ja/guides/getting-started/quickstart)と [Cloudflare](https://cloudflare.com/) アカウントが必要です。

> **警告:** Cloudflare Workers のファイルシステムは一時的なため、設定するすべてのストレージ（Observability ストレージを含む）は外部でホストする必要があります。[LibSQLStore](https://mastra.zisheng.pro/ja/reference/storage/libsql) でファイル URL を使用している場合は、リモートでホストされるデータベースに切り替えてください。

## インストール

`@mastra/deployer-cloudflare` パッケージをプロジェクトに追加します。

**npm**:

```bash
npm install @mastra/deployer-cloudflare@latest
```

**pnpm**:

```bash
pnpm add @mastra/deployer-cloudflare@latest
```

**Yarn**:

```bash
yarn add @mastra/deployer-cloudflare@latest
```

**Bun**:

```bash
bun add @mastra/deployer-cloudflare@latest
```

[`CloudflareDeployer`](https://mastra.zisheng.pro/ja/reference/deployer/cloudflare) をインポートし、Mastra 設定の Deployer として指定します。

```typescript
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',
    },
  }),
})
```

Cloudflare Worker をローカルでテストするには、[`wrangler` CLI](https://developers.cloudflare.com/workers/wrangler/install-and-update/) もインストールします。

**npm**:

```bash
npm install -D wrangler
```

**pnpm**:

```bash
pnpm add -D wrangler
```

**Yarn**:

```bash
yarn add --dev wrangler
```

**Bun**:

```bash
bun add --dev wrangler
```

## 使用方法

プロジェクトを設定したら、使用するリモート Git Provider（GitHub など）にプッシュします。

1. リポジトリを Cloudflare に接続します。"Workers & Pages" ダッシュボードで **Create application** を選択し、次の Step で Git Provider を選択します。設定を続け、デプロイするリポジトリを選択します。

   > **注記:** アプリケーションの実行に必要な環境変数（[モデル Provider](https://mastra.zisheng.pro/ja/models/providers) の API キーなど）を設定してください。`npx wrangler secret bulk .env` を使用すると、`.env` ファイルからシークレットをアップロードできます。詳しくは [Secrets](https://mastra.zisheng.pro/ja/reference/deployer/cloudflare) を参照してください。

2. 準備ができたら **Deploy** ボタンをクリックし、最初のデプロイが完了するまで待ちます。

3. `https://<your-project-name>.<slug>.workers.dev/api/agents` にアクセスして、新しくデプロイした Function を試します。利用可能なすべての Agent を一覧にした JSON レスポンスが返されます。

   [Mastra サーバー](https://mastra.zisheng.pro/ja/docs/server/mastra-server)はすべての API エンドポイントに `/api` を付けるため、リクエスト時の URL に追加する必要があります。

4. これで、Mastra エンドポイントを HTTP 経由で呼び出せます。

   > **注記:** エンドポイントを公開する前に、[認証](https://mastra.zisheng.pro/ja/docs/server/auth)を設定してください。