跳至主要內容

將 Mastra 部署至 Netlify

使用 @mastra/deployer-netlify 將 Mastra 伺服器部署至 Netlify。Deployer 會封裝程式碼，並產生符合 Netlify Frameworks API 的 .netlify 目錄，可直接部署。你可以部署為無伺服器函式（預設值），或部署為延遲較低、執行時間較長的邊緣函式。

資訊

本指南說明如何部署 Mastra 伺服器。若你使用伺服器轉接器或 Web 框架，請依該框架平常的方式部署。

開始之前
「開始之前」的直接連結

你需要一個 Mastra 應用程式和一個 Netlify 帳號。

警告

Netlify Functions 使用暫時性檔案系統，因此設定的任何儲存空間（包括可觀測性儲存空間）都必須託管於外部。若你使用的 LibSQLStore 採用檔案 URL，請改用遠端託管的資料庫。

安裝
「安裝」的直接連結

將 @mastra/deployer-netlify 套件加入專案：

npm install @mastra/deployer-netlify@latest

匯入 NetlifyDeployer，並在 Mastra 設定中將其設為 Deployer：

src/mastra/index.ts
import { Mastra } from '@mastra/core'
import { NetlifyDeployer } from '@mastra/deployer-netlify'

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

若要改為部署成邊緣函式，請傳入 { target: 'edge' }：

src/mastra/index.ts
import { Mastra } from '@mastra/core'
import { NetlifyDeployer } from '@mastra/deployer-netlify'

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

邊緣函式會在最靠近使用者的邊緣節點上以 Deno 執行。它們沒有固定的執行逾時限制（只有 CPU 時間限制），因此更適合長時間執行的 AI Workflow。詳情請參閱建構函式選項。

在專案根目錄建立 netlify.toml 檔案，內容如下：

[build]
command = "mastra build"

部署
「部署」的直接連結

設定專案後，將專案推送至你選擇的遠端 Git Provider（例如 GitHub）。

  1. 將儲存庫連接至 Netlify。在設定過程中，Netlify 會偵測 netlify.toml 檔案，並將建置指令設為 mastra build。

    備註

    請記得設定執行應用程式所需的環境變數（例如模型 Provider 的 API 金鑰）。

  2. 準備就緒後，按一下 Deploy 按鈕，等待第一次部署完成。畫面會顯示已部署一個函式。

  3. 前往 https://<random-slug>.netlify.app/api/agents 驗證部署；頁面應傳回 Agent 的 JSON 清單。

    由於 Mastra 伺服器會在每個 API 端點前加上 /api，因此提出要求時必須將其加入 URL。

    資訊

    Netlify 函式通常會部署至 https://<random-slug>.netlify.app/.netlify/functions/api。NetlifyDeployer 會將任何來自 /* 的要求重新導向至 /.netlify/functions/api/:splat，因此 URL 不需要包含 .netlify/functions 前置字串。

  4. 現在可以透過 HTTP 呼叫 Mastra 端點。

    警告

    將端點公開前，請先設定驗證。

On this page