본문으로 건너뛰기

Cloudflare에 Mastra 배포

사용@mastra/deployer-cloudflareCloudflare Workers에 Mastra 서버를 배포합니다. 배포자는 코드를 번들로 묶고wrangler.jsoncCloudflare를 준수하는 파일랭글러 구성, 추가 구성 없이 배포 준비가 완료되었습니다.

정보

당신이 사용하는 경우server adapter or web framework, 해당 프레임워크에서 평소 사용하는 방식으로 배포하세요.

시작하기 전에
시작하기 전에에 대한 직접 링크

당신은Mastra application and a Cloudflare account.

경고

Cloudflare 작업자는 임시 파일 시스템을 사용하므로 구성한 모든 저장소(관측성 저장소 포함)는 외부에서 호스팅되어야 합니다. 당신이 사용하는 경우LibSQLStore 를 파일 URL과 함께 사용하고 있다면 원격으로 호스팅되는 데이터베이스로 전환하세요.

설치
설치에 대한 직접 링크

추가@mastra/deployer-cloudflare package to your project:

npm install @mastra/deployer-cloudflare@latest

수입CloudflareDeployer 를 설치하고 Mastra 구성에서 deployer로 설정하세요:

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

Cloudflare Worker를 로컬에서 테스트하려면 다음도 설치하세요.wrangler CLI:

npm install -D wrangler

용법
용법에 대한 직접 링크

프로젝트를 설정한 후 선택한 원격 Git 공급자(예: GitHub)에 푸시하세요.

  1. 저장소를 Cloudflare에 연결하세요. "작업자 및 페이지" 대시보드에서Create application 를 선택하고 다음 단계에서 Git Provider를 선택하세요. 설정 절차를 계속 진행한 후 배포할 리포지토리를 선택하세요.

    노트

    애플리케이션을 실행하는 데 필요한 환경 변수(예:model provider API key). You can upload secrets from your .env file using npx wrangler secret bulk .env. See Secrets for details.

  2. 준비가 되었으면Deploy 버튼을 선택하고 첫 번째 배포가 완료될 때까지 기다리세요.

  3. 다음으로 이동하여 새로 배포된 기능을 사용해 보세요.https://<your-project-name>.<slug>.workers.dev/api/agents. 사용 가능한 모든 Agent를 나열하는 JSON 응답이 반환되어야 합니다.

    이후Mastra server prefixes every API endpoint with /api, 요청할 때 URL에 이를 추가해야 합니다.

  4. 이제 HTTP를 통해 Mastra 엔드포인트를 호출할 수 있습니다.

    노트

    설정authentication before exposing your endpoints publicly.

On this page