SuperAPI AI 工具集

railway-status

部署与运维

查看项目

更新于 10-15 11:57

技能介绍

Railway Status 是一个用于检查当前目录所关联 Railway 项目状态的技能。

用途

该技能用于查询当前目录对应的 Railway 项目状态。当用户询问 Railway 状态、项目、服务或部署情况,提到要部署或推送到 Railway,准备执行任何 Railway 操作(如部署、更新服务、添加变量),或询问环境与域名时,可使用该技能。

不适用场景

当用户需要以下内容时,应改用 railway-environment 技能:详细的服务配置(构建器类型、Dockerfile 路径、构建命令、根目录)、部署配置(启动命令、重启策略、健康检查、预部署命令)、服务来源(仓库、分支、镜像)、比较服务配置,以及查询或修改环境变量。

主要能力

该技能通过运行 railway status --json 获取项目状态,并解析 JSON 输出,展示以下信息:项目名称与工作区、当前环境(如 production、staging 等)、服务列表及其部署状态、进行中的部署(来自 activeDeployments 字段)、已配置的域名。每个服务上的 activeDeployments 数组显示当前正在运行的部署及其状态(如 building、deploying 等)。

使用方式

首先验证 CLI 是否已安装,运行:command -v railway。然后运行:railway status --json。

错误处理

CLI 未安装:如果 command -v railway 失败,提示 Railway CLI 未安装,可通过 npm install -g @railway/cli 或 brew install railway 安装,然后运行 railway login 进行认证。

未认证:如果 railway whoami 失败,提示未登录 Railway,需运行 railway login。

未关联项目:如果状态返回 "No linked project",提示当前目录未关联 Railway 项目。要关联已有项目,运行 railway link;要创建新项目,运行 railway init。

展示状态

解析 JSON 后按以下格式展示:项目名称与工作区、当前环境、服务列表及部署状态、进行中的部署、已配置域名。示例输出格式:

Project: my-app (workspace: my-team) Environment: production

Services:

  • web: deployed (https://my-app.up.railway.app)
  • api: deploying (build in progress)
  • postgres: running

限制

该技能仅用于状态查询,不涉及详细服务配置、部署配置、服务来源、配置比较或环境变量的查询与修改,这些场景需使用 railway-environment 技能。