メインコンテンツへ移動

Mastra を Digital Ocean にデプロイする

このガイドでは、Digital Ocean の App Platform と Droplets について説明します。それぞれに異なる強みがあり、適したプロジェクトの種類や開発者の経験も異なります。違いを理解してプロジェクトに最適な方法を選択するには、Digital Ocean の比較を参照してください。

情報

このガイドでは、Mastra サーバーのデプロイについて説明します。Server Adapter または Web フレームワークを使用している場合は、そのフレームワークの通常の方法でデプロイしてください。

始める前に
始める前にへの直接リンク

Mastra アプリケーションと Digital Ocean アカウントが必要です。

App Platform のファイルシステムは一時的なため、設定するすべてのストレージ（Observability ストレージを含む）は外部でホストする必要があります。LibSQLStore でファイル URL を使用している場合は、リモートでホストされるデータベースに切り替えてください。

App Platform
App Platformへの直接リンク

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

  1. 公式の App Platform クイックスタートに従います。リポジトリの接続、デプロイ元ブランチの選択、必要に応じたソースディレクトリの設定が案内されます。

  2. "Node.js" ビルドが検出されていることを確認します。ビルドコマンドを設定する必要があります。使用するパッケージマネージャーに合わせて設定してください。

    npm run build

  3. Mastra アプリケーションに必要な環境変数を追加します。これには API キー、データベース URL、その他の設定値が含まれます。

  4. アプリは自動的にビルドされ、デプロイされます。Digital Ocean から、デプロイ済みアプリケーションにアクセスするための URL が提供されます。

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

    警告

    エンドポイントを公開する前に、認証を設定してください。

Droplets
Dropletsへの直接リンク

前提条件
前提条件への直接リンク

  • Ubuntu 24.04 LTS 以降を実行する Droplet
  • Droplet を参照する A レコードを設定したドメイン名
  • 設定済みのリバースプロキシ（nginx など）
  • 設定済みの SSL 証明書（Let's Encrypt など）
  • Droplet にインストールされた Node.js 22.13.0 以降

デプロイする
デプロイするへの直接リンク

プロジェクトを設定したら、使用するリモート Git Provider（GitHub など）にプッシュします。Droplet に接続し、git がインストールされていることを確認してください。

  1. リポジトリをクローンします。

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

    リポジトリのディレクトリに移動します。

    cd "<your-repository>"

  2. プロジェクトの依存関係をインストールします。

    npm install

  3. Mastra アプリケーションに必要な環境変数を設定します。プロジェクトのルートに .env ファイルを作成します。

    touch .env

    .env ファイルを編集し、環境変数を追加します。

    .env
    OPENAI_API_KEY=your-api-key

  4. プロジェクトをビルドします。

    npm run build

    これにより、Mastra サーバーの本番ビルドが .mastra/output ディレクトリに作成されます。

  5. mastra start コマンドを実行して Mastra Server を起動できます。

    mastra start
    情報

    Mastra アプリケーションはデフォルトでポート 4111 で動作します。このポートにリクエストを転送するようにリバースプロキシを設定してください。

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

    警告

    エンドポイントを公開する前に、認証を設定してください。

On this page