跳到主要内容
非官方简体中文翻译,内容版权归 Mastra 所有,遵循 Apache-2.0 许可。

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 代码位置
uspdx(默认)俄勒冈州波特兰
usiad弗吉尼亚州阿什本
ussfo加利福尼亚州旧金山
euams(默认)荷兰阿姆斯特丹

当你需要将环境固定到特定数据中心时,请直接传入 Railway 代码。传入 us 会选择 pdx,传入 eu 会选择 ams。

备注

部署管线中还存在其他 Railway 区域(例如新加坡 sin),但尚未在驻留选择器中提供,因为托管数据库和可观测性在美国和欧盟以外没有本地放置。传入无法识别的区域会回退到美国默认值,而不是固定到该区域。

托管数据库放置
托管数据库放置的直接链接

当你附加环境作用域数据库时,平台会选择最接近环境的提供器区域。这由服务器决定,因此 mastra env db create <env> 上显式的 --region 会被忽略。环境的区域是唯一事实来源。

环境区域Turso 区域Postgres (Neon) 区域
pdxsjc(圣何塞)aws-us-west-2(俄勒冈)
iadiad(阿什本)aws-us-east-1(北弗吉尼亚)
sfosjc(圣何塞)aws-us-west-2(俄勒冈)
amsams(阿姆斯特丹)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 环境的遥测永远不会跨越到美国。

相关内容
相关内容的直接链接

On this page