[ PROMPT_NODE_26144 ]
environment-config
[ SKILL_DOCUMENTATION ]
# 环境配置参考
`EnvironmentConfig` 对象用于在 Railway 中配置服务、卷和共享变量。
## 结构
{
"services": {
"": {
"source": { ... },
"build": { ... },
"deploy": { ... },
"variables": { ... },
"networking": { ... }
}
},
"sharedVariables": { ... },
"volumes": { ... },
"buckets": { ... }
}
仅包含需要更改的字段。补丁将与现有配置合并。
## 服务配置
### 源码 (Source)
| 字段 | 类型 | 描述 |
|-------|------|-------------|
| `image` | string | Docker 镜像 (例如 `nginx:latest`) |
| `repo` | string | Git 仓库 URL |
| `branch` | string | 要部署的 Git 分支 |
| `commitSha` | string | 指定的提交 SHA |
| `rootDirectory` | string | 根目录 (用于 monorepo) |
| `checkSuites` | boolean | 等待 GitHub 检查套件完成 |
| `autoUpdates.type` | disabled | patch | minor | Docker 镜像自动更新策略 |
### 构建 (Build)
| 字段 | 类型 | 描述 |
|-------|------|-------------|
| `builder` | NIXPACKS | DOCKERFILE | RAILPACK | 构建系统 |
| `buildCommand` | string | Nixpacks 构建命令 |
| `dockerfilePath` | string | Dockerfile 路径 |
| `watchPatterns` | string[] | 触发部署的匹配模式 |
| `nixpacksConfigPath` | string | Nixpacks 配置文件路径 |
### 部署 (Deploy)
| 字段 | 类型 | 描述 |
|-------|------|-------------|
| `startCommand` | string | 容器启动命令 |
| `multiRegionConfig` | object | 区域 → 副本配置。参见 [多区域配置](#multi-region-config)。 |
| `healthcheckPath` | string | 健康检查端点 |
| `healthcheckTimeout` | number | 等待健康检查的秒数 |
| `restartPolicyType` | ON_FAILURE | ALWAYS | NEVER | 重启行为 |
| `restartPolicyMaxRetries` | number | 最大重启尝试次数 |
| `cronSchedule` | string | 定时任务的 Cron 表达式 |
| `sleepApplication` | boolean | 不活跃时休眠 |
### 变量 (Variables)
| 字段 | 类型 | 描述 |
|-------|------|-------------|
| `value` | string | 变量值 |
| `isOptional` | boolean | 允许空值 |
设置为 `null` 可删除变量。
关于变量引用,请参见 [variables.md](variables.md)。
### 生命周期 (Lifecycle)
| 字段 | 类型 | 描述 |
|-------|------|-------------|
| `isDeleted` | boolean | 标记为删除 (需要管理员权限) |
| `isCreated` | boolean | 标记为新创建 |
## 多区域配置
控制每个区域的副本数量。结构:区域名称 → `{