Regions
区域控制平台环境的运行位置、其托管数据库的放置位置,以及可观测性数据的存储位置。区域在创建环境时固定,之后无法更改。
Mastra platform 目前提供两个驻留区(residency zones):us 和 eu,由 Railway 上的特定计算区域支撑。数据库和可观测性会自动遵循环境的区域。
选择区域选择区域的直接链接
在创建环境或首次部署到环境时传入 --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(俄勒冈州波特兰)。
可用区域可用区域的直接链接
驻留选择器提供横跨两个区域的四个 Railway 区域。us 和 eu 简写会解析为每个区域中带下划线的默认值。
| 区域 | Railway 代码 | 位置 |
|---|---|---|
us | pdx(默认) | 俄勒冈州波特兰 |
us | iad | 弗吉尼亚州阿什本 |
us | sfo | 加利福尼亚州旧金山 |
eu | ams(默认) | 荷兰阿姆斯特丹 |
当你需要将环境固定到特定数据中心时,请直接传入 Railway 代码。传入 us 会选择 pdx,传入 eu 会选择 ams。
部署管线中还存在其他 Railway 区域(例如新加坡 sin),但尚未在驻留选择器中提供,因为托管数据库和可观测性在美国和欧盟以外没有本地放置。传入无法识别的区域会回退到美国默认值,而不是固定到该区域。
托管数据库放置托管数据库放置的直接链接
当你附加环境作用域数据库时,平台会选择最接近环境的提供器区域。这由服务器决定,因此 mastra env db create <env> 上显式的 --region 会被忽略。环境的区域是唯一事实来源。
| 环境区域 | 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,因为它们不绑定到单个环境。该标志请使用提供器区域 ID,而不是 us / eu 简写:
mastra env db create --kind turso --region fra
mastra env db create --kind neon --region aws-us-east-1
Turso 提供 20 多个区域,Postgres (Neon) 在美国、欧盟和亚太地区的 AWS 和 Azure 区域可用。完整列表请参阅 Turso 区域列表和 Neon 区域列表。传入提供器未提供的代码会在附加时失败,并返回提供器的错误。
Observability 共置Observability 共置的直接链接
目前可观测性摄取在两个区域运行:US(爱荷华,us-central1)和 EU(阿姆斯特丹)。每个环境的 traces、logs 和 metrics 都会路由到与其驻留区匹配的摄取区域:
| 环境区域 | Observability 区域 |
|---|---|
pdx、iad、sfo、us 简写 | US(爱荷华) |
ams、eu 简写 | EU(阿姆斯特丹) |
Railway 和数据库提供器提供的区域多于可观测性摄取区域,因此某些组合无法完全共置。us 区域中的环境始终将遥测发送到美国摄取,而 eu 区域中的环境使用欧盟摄取。即使底层 Railway 区域是没有专用摄取端点的城市,此路由仍会生效。数据驻留保持在区域级别。来自 eu 环境的遥测永远不会跨越到美国。