railway-project-management

用途

该技能提供使用 Railway CLI 对 Railway.com 项目、环境、服务和变量进行综合管理的完整工作流。它面向需要以命令行方式创建、关联、配置和验证 Railway 部署结构的用户。

主要能力

项目创建与关联：初始化新项目、关联已有项目、查看状态、在浏览器中打开、解除关联。
环境管理：列出、创建、复制、切换和删除环境，支持生产、预发、PR 环境及自定义环境。
服务操作：从 GitHub 仓库、当前目录、Docker 镜像或模板添加服务。
变量管理：设置服务变量、共享变量、密封变量和引用变量，支持删除与列出。
配置与设置：通过 railway.json 或 railway.toml 配置构建命令、启动命令、健康检查路径、重启策略等。
验证与校验：检查项目状态、环境、服务、变量、日志，并可在浏览器中可视化验证。

使用方式

前置条件：已安装并认证 Railway CLI（可使用 railway-auth 技能）；Git 仓库（用于 GitHub 集成）；Docker（可选，用于容器部署）。

常用命令示例：

项目操作：

railway init --name "my-project"
railway link -p <project-id>
railway status
railway open
railway unlink

环境操作：

railway environment --name staging
railway environment --name production-backup --duplicate
railway environment production
railway environment delete

服务操作：

railway add --repo owner/repo
railway add --image postgres:15
railway add --template postgres
railway list

变量操作：

railway variables set API_KEY=secret123
railway variables set --shared DATABASE_URL=postgres://...
railway variables set --sealed STRIPE_KEY=sk_live_...
railway variables set API_URL='${{ api-service.PUBLIC_URL }}'
railway variables delete API_KEY
railway variables list

配置示例（railway.json）：

{
  "build": {
    "builder": "NIXPACKS",
    "buildCommand": "npm run build"
  },
  "deploy": {
    "startCommand": "npm start",
    "healthcheckPath": "/health",
    "restartPolicyType": "ON_FAILURE"
  }
}

适用场景

初始化新的全栈项目并配置多环境。
在环境之间同步变量。
向已有项目添加数据库模板。
配置 PR 环境，使每个 PR 自动获得隔离环境。
使用引用变量模式实现服务间连接，避免重复配置。
使用密封变量保护生产密钥。

限制

需要预先安装并认证 Railway CLI。
GitHub 集成需要 Git 仓库。
Docker 部署需要安装 Docker（可选）。
部分设置（如 PR 环境启用、部署触发器）需通过仪表板完成。
密封变量创建后无法查看或解封，只能覆盖或删除。
资料中未提供具体收费、价格或平台支持范围等信息。

技能介绍

用途

主要能力

使用方式

适用场景

限制