[ PROMPT_NODE_26134 ]
railway-deployment
[ SKILL_DOCUMENTATION ]
# Railway 部署管理
管理现有的 Railway 部署:列表、查看日志、重新部署或移除。
**重要提示:** “移除部署” (`railway down`) 会停止当前部署但保留服务。若要彻底删除服务,请使用 railway-environment 智能体并将 `isDeleted` 设置为 `true`。
## 何时使用
- 用户说“移除部署”、“下线服务”、“停止部署”、“railway down”
- 用户想要“重新部署”、“重启服务”、“重启部署”
- 用户要求“列出部署”、“显示部署历史”、“查看部署状态”
- 用户要求“查看日志”、“显示日志”、“检查错误”、“调试问题”
## 列出部署
bash
railway deployment list --limit 10 --json
显示部署 ID、状态和元数据。用于查找特定部署 ID 以进行日志查看或调试。
### 指定服务
bash
railway deployment list --service backend --limit 10 --json
## 查看日志
### 部署日志
bash
railway logs --lines 100 --json
在非交互模式下,流式传输会自动禁用,CLI 获取日志后退出。
### 构建日志
bash
railway logs --build --lines 100 --json
用于调试构建失败或查看构建输出。
### 查看失败/进行中的部署日志
默认情况下 `railway logs` 显示最后一次成功的部署。使用 `--latest` 查看当前部署:
bash
railway logs --latest --lines 100 --json
### 过滤日志
bash
# 仅错误
railway logs --lines 50 --filter "@level:error" --json
# 文本搜索
railway logs --lines 50 --filter "connection refused" --json
# 组合过滤
railway logs --lines 50 --filter "@level:error AND timeout" --json
### 基于时间的过滤
bash
# 最近一小时的日志
railway logs --since 1h --lines 100 --json
# 30分钟前到10分钟前的日志
railway logs --since 30m --until 10m --lines 100 --json
# 特定时间戳的日志
railway logs --since 2024-01-15T10:00:00Z --lines 100 --json
格式:相对时间 (`30s`, `5m`, `2h`, `1d`, `1w`) 或 ISO 8601 时间戳。
### 查看特定部署的日志
部署日志:
bash
railway logs --lines 100 --json
构建日志:
bash
railway logs --build --lines 100 --json
从 `railway deployment list` 获取部署 ID。
**注意:** 部署 ID 是位置参数,而不是 `--deployment `。`--deployment` 标志是一个布尔值,用于选择部署日志(与用于构建日志的 `--build` 相对)。
## 重新部署
重新部署最近的一次部署:
bash
railway redeploy --servic