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

# Mastra を Amazon EC2 にデプロイする

Mastra サーバーを Amazon EC2 にデプロイします。サーバーは自分で管理するインフラストラクチャ上で動作し、長時間実行される Agent と Workflow をサポートできます。

> **情報:** このガイドでは、[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)
- Git と Node.js 22.13.0 以降がインストールされた [EC2](https://aws.amazon.com/ec2/) インスタンス（Ubuntu または Amazon Linux）

本番環境では、さらに次のものが必要です。

- インスタンスを参照するドメイン名（SSL 証明書に必要）
- ドメイン用の SSL 証明書（たとえば、Let's Encrypt と [Certbot](https://certbot.eff.org/) を使用）
- アプリケーションにトラフィックを転送するリバースプロキシ（[nginx](https://nginx.org/) など）

## デプロイする

1. EC2 インスタンスに接続し、リポジトリをクローンします。

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

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

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

   ```bash
   git clone git@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. `.env` ファイルを作成し、環境変数を追加します。

   ```bash
   touch .env
   ```

   アプリケーションの実行に必要な環境変数（モデル Provider の API キーなど）を設定してください。

   ```bash
   OPENAI_API_KEY=<your-openai-api-key>
   # Add other required environment variables
   ```

4. アプリケーションをビルドします。

   **npm**:

   ```bash
   npm run build
   ```

   **pnpm**:

   ```bash
   pnpm run build
   ```

   **Yarn**:

   ```bash
   yarn build
   ```

   **Bun**:

   ```bash
   bun run build
   ```

5. アプリケーションを実行します。

   ```bash
   node --env-file=".env" .mastra/output/index.mjs
   ```

   これは基本的な例です。本番環境では、[PM2](https://pm2.keymetrics.io/) や [systemd](https://systemd.io/) などのプロセスマネージャーを使用し、アプリケーションの継続実行と再起動を管理してください。

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

6. Mastra サーバーはポート 4111 で起動していますが、ローカルからしかアクセスできません。

   EC2 セキュリティグループでポート 4111 を開いて直接アクセスするか、ポート 80 と 443 でリッスンし、リクエストを `http://localhost:4111` に転送するリバースプロキシ（nginx など）を設定できます。

   本番環境では、HTTPS を設定できるようにリバースプロキシを使用してください。HTTPS はトラフィックを暗号化し、Agent が連携するほとんどの Webhook や外部サービスで必要になります。

7. `https://<your-ec2-address>/api/agents` にアクセスしてデプロイを確認します。Agent の一覧が JSON で返されます。

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

## 次のステップ

- [Mastra Client から接続する](https://mastra.zisheng.pro/ja/docs/server/mastra-client)
- [Deployment の概要](https://mastra.zisheng.pro/ja/docs/deployment/overview)