リージョン
リージョンは、platform 環境を実行する場所、ホスト型データベースを配置する場所、Observability データを保存する場所を制御します。リージョンは環境の作成時に固定され、後から変更することはできません。
Mastra platform では現在、us と eu の 2 つのデータレジデンシーゾーンを提供しており、Railway 上の特定のコンピューティングリージョンによって支えられています。データベースと Observability は、環境のリージョンに自動的に従います。
リージョンを選択するリージョンを選択するへの直接リンク
環境を作成するとき、または環境に初めてデプロイするときに --region を渡します。
mastra deploy --env production --region eu
mastra env create staging --region us
mastra deploy --region と mastra env create --region はどちらも、us / eu の省略形、または以下の表にある正式な Railway リージョンコードを受け付けます。省略形の使用を推奨します。
リージョンを指定しない場合のデフォルトは us で、pdx(オレゴン州ポートランド)に解決されます。
利用可能なリージョン利用可能なリージョンへの直接リンク
データレジデンシーセレクターでは、2 つのゾーンにまたがる 4 つの Railway リージョンを選択できます。us と eu の省略形は、それぞれのゾーンで下線が引かれたデフォルトに解決されます。
| ゾーン | Railway コード | 場所 |
|---|---|---|
us | pdx(デフォルト) | オレゴン州ポートランド |
us | iad | バージニア州アッシュバーン |
us | sfo | カリフォルニア州サンフランシスコ |
eu | ams(デフォルト) | オランダ、アムステルダム |
環境を特定のデータセンターに固定する必要がある場合は、Railway コードを直接渡します。us を渡すと pdx が選択され、eu を渡すと ams が選択されます。
デプロイパイプラインには他の Railway リージョン(シンガポールの sin など)も存在しますが、米国と EU 以外ではホスト型データベースと Observability をローカルに配置できないため、データレジデンシーセレクターではまだ選択できません。認識されないリージョンを渡すと、そのリージョンに固定されるのではなく、米国のデフォルトにフォールバックします。
ホスト型データベースの配置ホスト型データベースの配置への直接リンク
環境スコープのデータベースをアタッチすると、platform は環境に最も近いプロバイダーリージョンを選択します。この処理はサーバー側で決定されるため、明示的な --region を mastra env db create <env> に指定しても無視されます。環境のリージョンが信頼できる唯一の情報源です。
| 環境リージョン | Turso リージョン | Postgres(Neon)リージョン |
|---|---|---|
pdx | sjc(サンノゼ) | aws-us-west-2(オレゴン) |
iad | iad(アッシュバーン) | aws-us-east-1(北バージニア) |
sfo | sjc(サンノゼ) | aws-us-west-2(オレゴン) |
ams | ams(アムステルダム) | aws-eu-central-1(フランクフルト) |
プロジェクトスコープのデータベース(複数環境で共有)は単一の環境に紐づかないため、明示的な --region を受け付けます。このフラグには us / eu の省略形ではなく、プロバイダーのリージョン ID を指定してください。
mastra env db create --kind turso --region fra
mastra env db create --kind neon --region aws-us-east-1
Turso は 20 以上のリージョンを提供し、Postgres(Neon)は米国、EU、APAC の AWS と Azure リージョンで利用できます。全リージョンについては、Turso のリージョン一覧と Neon のリージョン一覧を参照してください。プロバイダーが提供していないコードを渡すと、アタッチ時にプロバイダーのエラーが発生します。
Observability のコロケーションObservability のコロケーションへの直接リンク
Observability の取り込み処理は現在、US(アイオワ、us-central1)と EU(アムステルダム)の 2 リージョンで実行されます。各環境のトレース、ログ、メトリクスは、そのデータレジデンシーゾーンに対応する取り込みリージョンにルーティングされます。
| 環境リージョン | Observability リージョン |
|---|---|
pdx、iad、sfo、省略形 us | US(アイオワ) |
ams、省略形 eu | EU(アムステルダム) |
コンピューティングとデータベースは Observability よりも多くの Railway およびプロバイダーリージョンに配置できるため、すべての組み合わせで完全にコロケーションできるわけではありません。基盤となる Railway リージョンが取り込みエンドポイントから直接提供されていない特定の都市であっても、us ゾーンの環境は常に米国の取り込み先にテレメトリを送信し、eu ゾーンの環境は常に EU の取り込み先にテレメトリを送信します。データレジデンシーはゾーン単位で維持されます。eu 環境のテレメトリが米国に送られることはありません。