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

# 設定

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

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

## プロジェクト設定

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

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

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

```json
{
  "projectId": "06daaac4-89b1-40f0-9e3f-0993e039a627",
  "projectName": "my-project",
  "organizationId": "org_01KNA5YSP52SX4M6YVSXC2MAHP"
}
```

| フィールド          | 説明                                                |
| -------------- | ------------------------------------------------- |
| projectId      | プロジェクトのUUID。プロジェクト作成時に割り当てられます。                   |
| projectName    | 人が読めるプロジェクト名。ダッシュボードとCLI出力の表示ラベルとして使用されます。        |
| organizationId | プロジェクトを所有する組織。すべてのデプロイ、APIキー、リソースはこの組織のスコープに属します。 |

## 環境変数

ローカルのenvファイルは任意です。[`mastra deploy`](https://mastra.zisheng.pro/ja/docs/mastra-platform/deploy)は、次の3つのソースから変数を解決します。

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

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

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

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

### Observability

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

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

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

## 複数の環境

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

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

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