[ PROMPT_NODE_26158 ]
railway-status
[ SKILL_DOCUMENTATION ]
# Railway 状态
检查当前目录的 Railway 项目状态。
## 何时使用
- 用户询问关于 Railway 状态、项目、服务或部署的问题
- 用户提到部署或推送到 Railway
- 在进行任何 Railway 操作之前(部署、更新服务、添加变量)
- 用户询问关于环境或域名的问题
## 何时不要使用
当用户需要以下内容时,请改用 railway-environment 工具:
- 详细的服务配置(构建器类型、Dockerfile 路径、构建命令、根目录)
- 部署配置(启动命令、重启策略、健康检查、预部署命令)
- 服务源(仓库、分支、镜像)
- 比较服务配置
- 查询或更改环境变量
## 检查状态
运行:
bash
railway status --json
首先验证 CLI 是否已安装:
bash
command -v railway
## 错误处理
### 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 并展示:
- **项目**:名称和工作区
- **环境**:当前环境(生产、预发布等)
- **服务**:带有部署状态的列表
- **活跃部署**:任何正在进行的部署(来自 `activeDeployments` 字段)
- **域名**:任何已配置的域名
示例输出格式:
Project: my-app (workspace: my-team)
Environment: production
Services:
- web: deployed (https://my-app.up.railway.app)
- api: deploying (build in progress)
- postgres: running
每个服务上的 `activeDeployments` 数组显示当前正在运行的部署及其状态(构建中、部署中等)。