본문으로 건너뛰기

디지털 오션에 Mastra 배포

이 가이드에서는 Digital Ocean의 앱 플랫폼과 Droplet을 다룹니다. 이러한 각 제품에는 고유한 장점이 있으며 다양한 유형의 프로젝트 및 개발자 전문 지식에 적합합니다. 읽다Digital Ocean's comparison차이점을 이해하고 프로젝트에 가장 적합한 옵션을 선택하세요.

정보

이 가이드에서는Mastra server. If you're using a server adapter또는웹 프레임워크, 해당 프레임워크에 대해 일반적인 방식으로 배포합니다.

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

당신은Mastra application and a Digital Ocean account.

그만큼App Platform 는 임시 파일 시스템을 사용하므로 구성하는 모든 스토리지(Observability 스토리지 포함)는 외부에서 호스팅해야 합니다. LibSQLStore 를 파일 URL과 함께 사용하고 있다면 원격으로 호스팅되는 데이터베이스로 전환하세요.

앱 플랫폼
앱 플랫폼에 대한 직접 링크

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

  1. 공식 팔로우App Platform quickstart. 이 과정에서는 리포지토리 연결, 배포할 브랜치 선택, 필요한 경우 소스 디렉터리 구성 방법을 안내합니다.

  2. "Node.js" 빌드가 감지되는지 확인하세요. 빌드 명령을 구성해야 합니다. 패키지 관리자에 따라 설정하십시오.

    npm run build

  3. Mastra 애플리케이션에 필요한 환경 변수를 추가합니다. 여기에는 API 키, 데이터베이스 URL 및 기타 구성 값이 포함됩니다.

  4. 앱이 자동으로 구축되고 배포됩니다. Digital Ocean은 배포된 애플리케이션에 액세스할 수 있는 URL을 제공합니다.

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

    경고

    설정authentication before exposing your endpoints publicly.

비말
비말에 대한 직접 링크

전제조건
전제조건에 대한 직접 링크

  • Ubuntu 24.04 LTS 이상을 실행하는 Droplet
  • 드롭릿을 가리키는 A 레코드가 있는 도메인 이름
  • 구성된 역방향 프록시(예:nginx)
  • 구성된 SSL 인증서(예:Let's Encrypt)
  • Node.js 22.13.0 이상이 드롭릿에 설치됨

배포
배포에 대한 직접 링크

프로젝트를 설정한 후 선택한 원격 Git 공급자(예: GitHub)에 푸시하세요. Droplet에 연결하고 확인하십시오.git is installed.

  1. 저장소를 복제합니다.

    git clone https://github.com/<your-username>/<your-repository>.git

    저장소 디렉터리로 이동합니다.

    cd "<your-repository>"

  2. 프로젝트 종속성을 설치합니다.

    npm install

  3. Mastra 애플리케이션에 필요한 환경 변수를 설정합니다. 만들기.env file in the root of your project:

    touch .env

    편집하다.env file and add your environment variables:

    .env
    OPENAI_API_KEY=your-api-key

  4. 프로젝트를 빌드합니다.

    npm run build

    이렇게 하면 Mastra 서버의 프로덕션 빌드가 생성됩니다..mastra/output directory.

  5. 당신은 실행할 수 있습니다Mastra Server by running the mastra start command:

    mastra start
    정보

    Mastra 애플리케이션은 기본적으로 포트 4111에서 실행됩니다. 요청을 이 포트로 전달하도록 역방향 프록시가 구성되어 있는지 확인하세요.

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

    경고

    설정authentication before exposing your endpoints publicly.

On this page