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

# Mastra を Netlify にデプロイする

`@mastra/deployer-netlify` を使用して、Mastra サーバーを Netlify にデプロイします。Deployer はコードをバンドルし、Netlify の [Frameworks API](https://docs.netlify.com/build/frameworks/frameworks-api/) に準拠した `.netlify` ディレクトリを生成します。デフォルトでは Serverless Function としてデプロイしますが、レイテンシを下げ、実行時間を延ばすために [Edge Function](https://docs.netlify.com/build/edge-functions/overview/) としてデプロイすることもできます。

> **情報:** このガイドでは、[Mastra サーバー](https://mastra.zisheng.pro/ja/docs/server/mastra-server)のデプロイについて説明します。[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)と [Netlify](https://www.netlify.com/) アカウントが必要です。

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

## インストール

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

**npm**:

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

**pnpm**:

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

**Yarn**:

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

**Bun**:

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

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

```typescript
import { Mastra } from '@mastra/core'
import { NetlifyDeployer } from '@mastra/deployer-netlify'

export const mastra = new Mastra({
  deployer: new NetlifyDeployer(),
})
```

代わりに Edge Function としてデプロイするには、`{ target: 'edge' }` を渡します。

```typescript
import { Mastra } from '@mastra/core'
import { NetlifyDeployer } from '@mastra/deployer-netlify'

export const mastra = new Mastra({
  deployer: new NetlifyDeployer({
    target: 'edge',
  }),
})
```

Edge Function はユーザーに最も近いエッジ上の Deno で動作します。厳密な実行タイムアウトはなく、CPU 時間の上限のみであるため、実行時間の長い AI Workflow に適しています。詳しくは[コンストラクターのオプション](https://mastra.zisheng.pro/ja/reference/deployer/netlify)を参照してください。

プロジェクトルートに、次の内容で `netlify.toml` ファイルを作成します。

```toml
[build]
command = "mastra build"
```

## デプロイする

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

1. リポジトリを Netlify に接続します。設定中に Netlify が `netlify.toml` ファイルを検出し、ビルドコマンドを `mastra build` に設定します。

   > **注記:** アプリケーションの実行に必要な環境変数（[モデル Provider](https://mastra.zisheng.pro/ja/models/providers) の API キーなど）を設定してください。

2. 準備ができたら **Deploy** ボタンをクリックし、最初のデプロイが完了するまで待ちます。1 つの Function がデプロイされたことが表示されます。

3. `https://<random-slug>.netlify.app/api/agents` でデプロイを確認します。Agent の一覧が JSON で返されます。

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

   > **情報:** Netlify Functions は通常、`https://<random-slug>.netlify.app/.netlify/functions/api` にデプロイされます。`NetlifyDeployer` は `/*` へのすべてのリクエストを `/.netlify/functions/api/:splat` にリダイレクトするため、URL に `.netlify/functions` プレフィックスを含める必要はありません。

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

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