Mastra platform の Studio

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

以下のように CLI から Studio をデプロイするか、GitHub リポジトリをリンクして push-to-deploy を利用できます。リポジトリをリンクする手順については、GitHub インテグレーションを参照してください。

注記

mastra studio deploy は以前の分割されたデプロイ方法です。新しいプロジェクトでは、事前検証、環境、CLI 管理のデータベースを追加する統合コマンド mastra deploy を使用してください。

クイックスタート

1. スタートガイドに従って、最初の Mastra プロジェクトを作成します。

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

   npm

   npm install -g mastra

   pnpm

   pnpm add -g mastra

   Yarn

   yarn global add mastra

   Bun

   bun add --global mastra

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

   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 リファレンスを参照してください。

環境ファイル

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

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

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

同じコードベースを production と staging で実行するには、代わりに統合コマンド mastra deploy --env を使用します。環境は、環境ごとに1つのプロジェクトを用意する従来の方式に代わるものです。

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

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

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

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

Studio をセルフホストする

独自のインフラストラクチャに Studio をデプロイする方法については、Studio のデプロイを参照してください。

関連項目

• mastra studio deploy