> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ja/llms.txt

# Mastra を Digital Ocean にデプロイする

このガイドでは、Digital Ocean の App Platform と Droplets について説明します。それぞれに異なる強みがあり、適したプロジェクトの種類や開発者の経験も異なります。違いを理解してプロジェクトに最適な方法を選択するには、[Digital Ocean の比較](https://www.digitalocean.com/community/conceptual-articles/digitalocean-app-platform-vs-doks-vs-droplets)を参照してください。

> **情報:** このガイドでは、[Mastra サーバー](https://mastra.zisheng.pro/ja/docs/server/mastra-server)のデプロイについて説明します。[Server Adapter](https://mastra.zisheng.pro/ja/docs/server/server-adapters) または [Web フレームワーク](https://mastra.zisheng.pro/ja/docs/deployment/web-framework)を使用している場合は、そのフレームワークの通常の方法でデプロイしてください。

## 始める前に

[Mastra アプリケーション](https://mastra.zisheng.pro/ja/guides/getting-started/quickstart)と [Digital Ocean](https://www.digitalocean.com/) アカウントが必要です。

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

## App Platform

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

1. 公式の [App Platform クイックスタート](https://docs.digitalocean.com/products/app-platform/getting-started/quickstart/#create-an-app)に従います。リポジトリの接続、デプロイ元ブランチの選択、必要に応じたソースディレクトリの設定が案内されます。

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

   **npm**:

   ```bash
   npm run build
   ```

   **pnpm**:

   ```bash
   pnpm run build
   ```

   **Yarn**:

   ```bash
   yarn build
   ```

   **Bun**:

   ```bash
   bun run build
   ```

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

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

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

   > **警告:** エンドポイントを公開する前に、[認証](https://mastra.zisheng.pro/ja/docs/server/auth)を設定してください。

## Droplets

### 前提条件

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

### デプロイする

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

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

   **公開リポジトリ**:

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

   **非公開リポジトリ**:

   ```bash
   git clone https://<your-username>:<your-personal-access-token>@github.com/<your-username>/<your-repository>.git
   ```

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

   ```bash
   cd "<your-repository>"
   ```

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

   **npm**:

   ```bash
   npm install
   ```

   **pnpm**:

   ```bash
   pnpm install
   ```

   **Yarn**:

   ```bash
   yarn install
   ```

   **Bun**:

   ```bash
   bun install
   ```

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

   ```bash
   touch .env
   ```

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

   ```bash
   OPENAI_API_KEY=your-api-key
   ```

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

   **npm**:

   ```bash
   npm run build
   ```

   **pnpm**:

   ```bash
   pnpm run build
   ```

   **Yarn**:

   ```bash
   yarn build
   ```

   **Bun**:

   ```bash
   bun run build
   ```

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

5. `mastra start` コマンドを実行して [Mastra Server](https://mastra.zisheng.pro/ja/docs/deployment/mastra-server) を起動できます。

   ```bash
   mastra start
   ```

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

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

   > **警告:** エンドポイントを公開する前に、[認証](https://mastra.zisheng.pro/ja/docs/server/auth)を設定してください。

## 関連項目

- [Digital Ocean App Platform](https://docs.digitalocean.com/products/app-platform/)
- [Digital Ocean Droplets](https://docs.digitalocean.com/products/droplets/)