Digital Ocean
Digital Ocean の App Platform と Droplets に Mastra アプリケーションをデプロイします。
このガイドは、デフォルトの
npx create-mastra@latest
コマンドで Mastra アプリケーションを作成したことを前提としています。
新しく Mastra アプリケーションを作成する方法については、
クイックスタートガイド を参照してください。
App Platform
App Platform
前提条件
- Mastra アプリケーションを含む Git リポジトリ。GitHub リポジトリ、GitLab リポジトリ、またはその他の互換性のあるソースプロバイダーを使用できます。
- DigitalOcean アカウント
デプロイ手順
新しいアプリを作成
- DigitalOcean ダッシュボード にログインします。
- App Platform サービスに移動します。
- ソースプロバイダーを選択し、新しいアプリを作成します。
デプロイ元の設定
- リポジトリに接続して選択します。コンテナイメージやサンプルアプリを選ぶこともできます。
- デプロイに使用するブランチを選択します。
- 必要に応じてソースディレクトリを指定します。Mastra アプリがデフォルトのディレクトリ構成を使用している場合は、設定不要です。
- 次のステップへ進みます。
リソース設定と環境変数の構成
- Node.js のビルドは自動検出されます。
- ビルドコマンドの設定: App Platform が Mastra プロジェクトを正しくビルドできるよう、カスタムビルドコマンドを追加してください。パッケージマネージャに応じて設定します:
npm
npm run build
- Mastra アプリに必要な環境変数を追加します。API キー、データベース URL、その他の設定値などが含まれます。
- ここでリソースのサイズを調整できます。
- オプションで、リソースのリージョン、一意のアプリ名、リソースの所属プロジェクトなども設定できます。
- 設定と料金見積もりを確認し、問題なければアプリを作成します。
デプロイ
- アプリは自動的にビルドおよびデプロイされます。
- DigitalOcean からデプロイ済みアプリにアクセスできる URL が提供されます。
これで、DigitalOcean によって提供された URL からデプロイ済みアプリにアクセスできます。
DigitalOcean App Platform はエフェメラル(短期)なファイルシステムを使用しています。
つまり、ファイルシステムに書き込まれたファイルは短期間で消失する可能性があります。
ファイルシステムを使用する Mastra のストレージプロバイダーの利用は避けてください。
例:ファイル URL を用いる LibSQLStore
。
Mastra サーバーへの接続
@mastra/client-js
パッケージの MastraClient
を使うと、クライアントアプリケーションから Mastra サーバーに接続できます。
詳しくは、MastraClient
のドキュメントをご覧ください。
import { MastraClient } from "@mastra/client-js";
const mastraClient = new MastraClient({
baseUrl: "https://<your-domain-name>",
});