Skip to Content
リファレンスデプロイヤーNetlify

NetlifyDeployer

NetlifyDeployerは、スタンドアロンのMastraアプリケーションをNetlify Functionsにデプロイし、サイトの作成、設定、およびデプロイメントプロセスを処理します。抽象Deployerクラスを拡張して、Netlify固有のデプロイメント機能を提供します。

インストール

npm install @mastra/deployer-netlify@latest

使用例

src/mastra/index.ts
import { Mastra } from "@mastra/core";
import { NetlifyDeployer } from "@mastra/deployer-netlify";
 
const mastra = new Mastra({
  // ...
  deployer: new NetlifyDeployer()
});

Mastraプロジェクトのリント

Mastraプロジェクトをリントして、ビルドに問題がないことを確認します

npx mastra lint

Mastraプロジェクトのビルド

NetlifyデプロイメントのためにMastraプロジェクトをビルドするには：

npx mastra build

ビルドプロセスは.mastra/outputディレクトリに以下の出力構造を生成します：

.netlify/
├── v1/
    └── functions/
    │   └── api/
    │       └── index.mjs    # アプリケーションエントリーポイント
    │ config.json            # Netlify設定

Netlify設定

NetlifyDeployerは自動的に.netlify/v1に以下の設定を含むconfig.json設定ファイルを生成します：

{
  "redirects": [
    {
      "force": true,
      "from": "/*",
      "to": "/.netlify/functions/api/:splat",
      "status": 200
    }
  ]
}

デプロイオプション

ビルド後、以下のいずれかの方法を使用してMastraアプリケーション.mastra/outputをNetlifyにデプロイできます：

  1. Netlify CLI: Netlifyの公式CLIツールを使用して直接デプロイ

    • CLIをインストール: npm install -g netlify-cli
    • 関数ディレクトリを指定してデプロイ: netlify deploy
    • 本番デプロイの場合は--prodフラグを追加: netlify deploy --prod

  2. Netlify Dashboard: Gitリポジトリを接続するか、Netlifyダッシュボード経由でビルド出力をドラッグアンドドロップ

MastraプロジェクトのGitリポジトリをNetlifyに接続する際は、Netlifyがプロジェクトルートからの相対パスを解決するため、以下の推奨ビルド設定を使用してください：

# Build command
npm run build
  1. Netlify Dev: Netlifyの開発環境でMastraアプリケーションをローカルで実行

プロジェクトルートでnetlify devを実行して、Mastraアプリケーションをローカルでテストすることもできます。

プラットフォームドキュメント

CloudflareVercel