メインコンテンツへ移動

設定

Mastra platformにデプロイすると、CLIは.mastra-project.json設定ファイルを生成し、platformと、必要に応じてローカルの.envファイルから環境変数を解決します。

このページでは、両方の仕組みについて説明します。

プロジェクト設定
プロジェクト設定への直接リンク

.mastra-project.jsonファイルは、最初のmastra deployで自動生成されます。このファイルによって、ローカルプロジェクトがplatform上のプロジェクトに関連付けられます。GitHub連携でも、リンクされたリポジトリに同じファイルが書き込まれます。

以降のデプロイ（CIからのデプロイを含む）が正しいプロジェクトを対象にするよう、バージョン管理にコミットしてください。

ファイルは次のようになります。

.mastra-project.json
{
  "projectId": "06daaac4-89b1-40f0-9e3f-0993e039a627",
  "projectName": "my-project",
  "organizationId": "org_01KNA5YSP52SX4M6YVSXC2MAHP"
}
フィールド説明
projectIdプロジェクトのUUID。プロジェクト作成時に割り当てられます。
projectName人が読めるプロジェクト名。ダッシュボードとCLI出力の表示ラベルとして使用されます。
organizationIdプロジェクトを所有する組織。すべてのデプロイ、APIキー、リソースはこの組織のスコープに属します。

環境変数
環境変数への直接リンク

ローカルのenvファイルは任意です。mastra deployは、次の3つのソースから変数を解決します。

  • 管理変数: ホステッドデータベースなどのplatformリソースによって注入されます。platformが定義するため、編集できません。
  • 保存変数: ダッシュボードを通じてプロジェクトまたは環境に保存されます。ローカルファイルがなくても、デプロイのたびにそのまま使用されます。
  • ローカルenvファイル: デプロイ時に、明示的に指定した--env-file、または現在の.envと.env.localファイルの値が上位レイヤーとして適用されます。.env.localの変数は.envの変数を上書きします。

デフォルトの選択に任せず、特定のenvファイルをデプロイに使用するには、--env-fileを渡します。

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

開発専用または個人的なシークレットをアップロードしないよう、デプロイ前にローカルのenvファイルを確認し、不要な情報を除去してください。

Observability
Observabilityへの直接リンク

次の環境変数で、Mastra platformのObservability製品を設定します。

変数説明
MASTRA_PLATFORM_ACCESS_TOKEN組織スコープのアクセストークン。CLIはObservabilityのプロビジョニング時にこれを書き込み、platform認証に使用します。
MASTRA_PROJECT_IDplatformプロジェクトのUUID。MastraPlatformExporterは、Observabilityデータをplatformプロジェクトに関連付けるために使用します。StudioとServerのデプロイは、.mastra-project.jsonからプロジェクトIDを読み取ります。
MASTRA_PLATFORM_OBSERVABILITY_ENDPOINT任意のObservabilityエンドポイント上書き。ローカルでplatformを開発する場合にのみ自動設定されます。デフォルトはhttps://observability.mastra.aiです。
MASTRA_ORG_IDCLIコマンドでアクティブな組織を上書きします。対応するコマンドでは--orgフラグでも設定できます。

MastraPlatformExporterは、platformへのエクスポートを認証するためにMASTRA_PLATFORM_ACCESS_TOKENを読み取ります。

複数の環境
複数の環境への直接リンク

1つのプロジェクトは、productionやstagingなど、複数の環境で同じコードベースを実行します。各環境には固有のURL、保存変数、デプロイ履歴があります。1つの.mastra-project.jsonファイルですべての環境を扱えます。

mastra deploy --env production --yes
mastra deploy --env staging --env-file .env.staging --yes
注記

以前のplatformバージョンでは、環境ごとに1つのプロジェクトが必要でした。現在は環境がそのパターンに代わるため、1つのプロジェクトを維持し、各環境にデプロイしてください。

On this page