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

# Mastra platform の Studio

Mastra platform の Studio は、Agent のテスト、Workflow の実行、Trace の調査に使用できる、ホストされたビジュアルワークスペースです。Studio UI を自分でホストせずにチームで Studio を共有したい場合に使用します。

以下のように CLI から Studio をデプロイするか、GitHub リポジトリをリンクして push-to-deploy を利用できます。リポジトリをリンクする手順については、[GitHub インテグレーション](https://mastra.zisheng.pro/ja/docs/mastra-platform/github)を参照してください。

> **注記:** `mastra studio deploy` は以前の分割されたデプロイ方法です。新しいプロジェクトでは、事前検証、環境、CLI 管理のデータベースを追加する統合コマンド [`mastra deploy`](https://mastra.zisheng.pro/ja/docs/mastra-platform/deploy) を使用してください。

## クイックスタート

1. [スタートガイド](https://mastra.zisheng.pro/ja/docs)に従って、最初の Mastra プロジェクトを作成します。

2. `mastra` CLI をグローバルにインストールします。

   **npm**:

   ```bash
   npm install -g mastra
   ```

   **pnpm**:

   ```bash
   pnpm add -g mastra
   ```

   **Yarn**:

   ```bash
   yarn global add mastra
   ```

   **Bun**:

   ```bash
   bun add --global mastra
   ```

3. 1つのコマンドで Studio をデプロイします。

   ```bash
   mastra studio deploy
   ```

   デプロイに成功すると、CLI にデプロイされた Studio インスタンスの URL が表示されます。

初回デプロイ時、CLI は新しいプロジェクトを作成するか、既存のプロジェクトを選択するよう求めます。その後、プロジェクトディレクトリに `.mastra-project.json` ファイルを作成します。このファイルはローカルプロジェクトを platform のプロジェクトにリンクします。ファイルには `projectId`、`projectName`、`organizationId` が含まれます。CI/CD がデプロイ先のプロジェクトを特定できるよう、このファイルをリポジトリにコミットしてください。

## デプロイの仕組み

`mastra studio deploy` コマンドはプロジェクトをビルドし、`src/mastra/` を `.mastra/output` にコンパイルします。その出力をアーティファクト ZIP としてパッケージ化し、クラウド Sandbox にアップロードしてデプロイします。

デプロイは **queued → uploading → starting → running** の順に遷移し、問題が発生した場合は **failed** になります。プロジェクトの Sandbox がすでに実行中の場合、platform はダウンタイムなしでその場で更新します。それ以外の場合は、新しい Sandbox を作成します。インスタンス URL はプロジェクトの slug ごとに割り当てられ、デプロイ後も変わりません。

フラグの全一覧と CI/CD での使用方法については、[`mastra studio deploy` CLI リファレンス](https://mastra.zisheng.pro/ja/reference/cli/mastra)を参照してください。

## 環境ファイル

ローカルの env ファイルは任意です。プロジェクトディレクトリに `.env` または `.env.*` ファイルがある場合、デプロイ時にその環境変数がバンドルされます。

複数の env ファイルがある場合、CLI は使用するファイルの選択を求めます。非対話形式で選択するには、`--env-file` を渡します。

```bash
mastra studio deploy --env-file .env.production --yes
```

同じコードベースを `production` と `staging` で実行するには、代わりに統合コマンド [`mastra deploy --env`](https://mastra.zisheng.pro/ja/docs/mastra-platform/deploy) を使用します。[環境](https://mastra.zisheng.pro/ja/docs/mastra-platform/environments)は、環境ごとに1つのプロジェクトを用意する従来の方式に代わるものです。

## 非対話形式で新しいプロジェクトを作成する

`mastra studio deploy` は初回実行時にプロジェクトを作成できます。`--project <name>` が既存のプロジェクトと一致しない場合、CLI はその値を新しいプロジェクト名として使用し、確認後に作成します。`--yes` と組み合わせれば、完全にスクリプト化できます。

```bash
mastra studio deploy --project "my-new-project" --yes
```

対話形式でしか使えない `mastra studio projects create` の代わりに、CI や AI コーディング Agent からこの方法を使用してください。

## Studio をセルフホストする

独自のインフラストラクチャに Studio をデプロイする方法については、[Studio のデプロイ](https://mastra.zisheng.pro/ja/docs/studio/deployment)を参照してください。

## 関連項目

- [`mastra studio deploy`](https://mastra.zisheng.pro/ja/reference/cli/mastra)