railway-deployment

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Railway Deployment Management

Railway部署管理

Manage existing Railway deployments: list, view logs, redeploy, or remove.

Important: "Remove deployment" (

railway down

) stops the current deployment but keeps the service. To delete a service entirely, use the railway-environment skill with

isDeleted: true

管理现有的Railway部署：列出部署、查看日志、重新部署或移除部署。

重要说明： "移除部署"（

railway down

）会停止当前部署，但保留服务。若要完全删除服务，请使用带有

isDeleted: true

参数的railway-environment技能。

When to Use

使用场景

User says "remove deploy", "take down service", "stop deployment", "railway down"
User wants to "redeploy", "restart the service", "restart deployment"
User asks to "list deployments", "show deployment history", "deployment status"
User asks to "see logs", "show logs", "check errors", "debug issues"

用户提及"remove deploy"、"take down service"、"stop deployment"、"railway down"时
用户想要"重新部署"、"重启服务"、"重启部署"时
用户要求"列出部署"、"查看部署历史"、"部署状态"时
用户询问"查看日志"、"显示日志"、"检查错误"、"调试问题"时

List Deployments

列出部署

bash

railway deployment list --limit 10 --json

Shows deployment IDs, statuses, and metadata. Use to find specific deployment IDs for logs or debugging.

bash

railway deployment list --limit 10 --json

显示部署ID、状态和元数据。用于查找特定部署ID以进行日志查看或调试。

Specify Service

指定服务

bash

railway deployment list --service backend --limit 10 --json

bash

railway deployment list --service backend --limit 10 --json

View Logs

查看日志

Deploy Logs

部署日志

bash

railway logs --lines 100 --json

In non-interactive mode, streaming is auto-disabled and CLI fetches logs then exits.

bash

railway logs --lines 100 --json

在非交互模式下，流模式会自动禁用，CLI将获取日志后退出。

Build Logs

构建日志

bash

railway logs --build --lines 100 --json

For debugging build failures or viewing build output.

bash

railway logs --build --lines 100 --json

用于调试构建失败或查看构建输出。

Logs for Failed/In-Progress Deployments

失败/进行中部署的日志

By default

railway logs

shows the last successful deployment. Use

--latest

for current:

bash

railway logs --latest --lines 100 --json

默认情况下，

railway logs

显示最后一次成功的部署日志。使用

--latest

参数查看当前部署的日志：

bash

railway logs --latest --lines 100 --json

Filter Logs

过滤日志

bash

undefined

bash

undefined

Errors only

仅显示错误

railway logs --lines 50 --filter "@level:error" --json

Text search

文本搜索

railway logs --lines 50 --filter "connection refused" --json

Combined

组合过滤

railway logs --lines 50 --filter "@level:error AND timeout" --json

undefined

railway logs --lines 50 --filter "@level:error AND timeout" --json

undefined

Time-Based Filtering

基于时间的过滤

bash

undefined

bash

undefined

Logs from last hour

Logs between 30 and 10 minutes ago

30分钟到10分钟前的日志

railway logs --since 30m --until 10m --lines 100 --json

Logs from specific timestamp

特定时间戳的日志

railway logs --since 2024-01-15T10:00:00Z --lines 100 --json


Formats: relative (`30s`, `5m`, `2h`, `1d`, `1w`) or ISO 8601 timestamps.

railway logs --since 2024-01-15T10:00:00Z --lines 100 --json


格式支持相对时间（`30s`、`5m`、`2h`、`1d`、`1w`）或ISO 8601时间戳。

Logs from Specific Deployment

特定部署的日志

Deploy logs:

bash

railway logs <deployment-id> --lines 100 --json

Build logs:

bash

railway logs --build <deployment-id> --lines 100 --json

Get deployment ID from

railway deployment list

Note: The deployment ID is a positional argument, NOT

--deployment <id>

. The

--deployment

flag is a boolean that selects deploy logs (vs

--build

for build logs).

部署日志：

bash

railway logs <deployment-id> --lines 100 --json

构建日志：

bash

railway logs --build <deployment-id> --lines 100 --json

部署ID可通过

railway deployment list

命令获取。

注意： 部署ID是位置参数，而非

--deployment <id>

形式。

--deployment

是一个布尔标志，用于选择部署日志（与之相对的是

--build

标志用于选择构建日志）。

Redeploy

重新部署

Redeploy the most recent deployment:

bash

railway redeploy --service <name> -y

The

-y

flag skips confirmation. Useful when:

Config changed via railway-environment skill
Need to restart without new code
Previous deploy succeeded but service misbehaving

重新部署最近的部署：

bash

railway redeploy --service <name> -y

-y

标志用于跳过确认。适用于以下场景：

通过railway-environment技能修改了配置
需要在不更新代码的情况下重启服务
之前的部署成功，但服务运行异常

Restart Container Only

仅重启容器

Restart without rebuilding (picks up external resource changes):

bash

railway restart --service <name> -y

Use when external resources (S3 files, config maps) changed but code didn't.

无需重新构建即可重启服务（会获取外部资源的变更）：

bash

railway restart --service <name> -y

适用于外部资源（如S3文件、配置映射）发生变更但代码未修改的场景。

Remove Deployment

移除部署

Takes down the current deployment. The service remains but has no running deployment.

bash

undefined

停止当前部署。服务会保留，但没有运行中的部署。

bash

undefined

Remove deployment for linked service

移除关联服务的部署

railway down -y

Remove deployment for specific service

移除特定服务的部署

railway down --service web -y railway down --service api -y


This is what users mean when they say "remove deploy", "take down", or "stop the deployment".

**Note:** This does NOT delete the service. To delete a service entirely, use the railway-environment skill with `isDeleted: true`.

railway down --service web -y railway down --service api -y


这对应用户所说的"remove deploy"、"take down"或"stop the deployment"操作。

**注意：** 此操作不会删除服务。若要完全删除服务，请使用带有`isDeleted: true`参数的railway-environment技能。

CLI Options

CLI选项

deployment list

Flag	Description
`-s, --service <NAME>`	Service name or ID
`-e, --environment <NAME>`	Environment name or ID
`--limit <N>`	Max deployments (default 20, max 1000)
`--json`	JSON output

标志	描述
`-s, --service <NAME>`	服务名称或ID
`-e, --environment <NAME>`	环境名称或ID
`--limit <N>`	最大部署数量（默认20，最大1000）
`--json`	以JSON格式输出

logs

Flag	Description
`-s, --service <NAME>`	Service name or ID
`-e, --environment <NAME>`	Environment name or ID
`-d, --deployment`	Show deploy logs (default, boolean flag)
`-b, --build`	Show build logs (boolean flag)
`-n, --lines <N>`	Number of lines (required)
`-f, --filter <QUERY>`	Filter using query syntax
`--since <TIME>`	Start time (relative or ISO 8601)
`--until <TIME>`	End time (relative or ISO 8601)
`--latest`	Most recent deployment (even if failed)
`--json`	JSON output
`[DEPLOYMENT_ID]`	Specific deployment (optional)

标志	描述
`-s, --service <NAME>`	服务名称或ID
`-e, --environment <NAME>`	环境名称或ID
`-d, --deployment`	显示部署日志（默认选项，布尔标志）
`-b, --build`	显示构建日志（布尔标志）
`-n, --lines <N>`	日志行数（必填）
`-f, --filter <QUERY>`	使用查询语法过滤日志
`--since <TIME>`	起始时间（相对时间或ISO 8601格式）
`--until <TIME>`	结束时间（相对时间或ISO 8601格式）
`--latest`	显示最近的部署日志（即使部署失败）
`--json`	以JSON格式输出
`[DEPLOYMENT_ID]`	特定部署的ID（可选）

redeploy

Flag	Description
`-s, --service <NAME>`	Service name or ID
`-y, --yes`	Skip confirmation

标志	描述
`-s, --service <NAME>`	服务名称或ID
`-y, --yes`	跳过确认步骤

restart

Flag	Description
`-s, --service <NAME>`	Service name or ID
`-y, --yes`	Skip confirmation

标志	描述
`-s, --service <NAME>`	服务名称或ID
`-y, --yes`	跳过确认步骤

down

Flag	Description
`-s, --service <NAME>`	Service name or ID
`-e, --environment <NAME>`	Environment name or ID
`-y, --yes`	Skip confirmation

标志	描述
`-s, --service <NAME>`	服务名称或ID
`-e, --environment <NAME>`	环境名称或ID
`-y, --yes`	跳过确认步骤

Presenting Logs

日志展示建议

When showing logs:

Include timestamps
Highlight errors and warnings
For build failures: show error and suggest fixes
For runtime crashes: show stack trace context
Summarize patterns (e.g., "15 timeout errors in last 100 logs")

展示日志时：

包含时间戳
高亮显示错误和警告信息
对于构建失败：显示错误信息并给出修复建议
对于运行时崩溃：显示堆栈跟踪上下文
总结日志中的模式（例如："最近100条日志中出现15次超时错误"）

Composability

组合使用

Push new code: Use railway-deploy skill
Check service status: Use railway-status skill
Fix config issues: Use railway-environment skill
Create new service: Use railway-new skill

推送新代码：使用railway-deploy技能
检查服务状态：使用railway-status技能
修复配置问题：使用railway-environment技能
创建新服务：使用railway-new技能

Error Handling

错误处理

No Service Linked

未关联服务

No service linked. Run `railway service` to select one.

No service linked. Run `railway service` to select one.

No Deployments Found

未找到部署

No deployments found. Deploy first with `railway up`.

No deployments found. Deploy first with `railway up`.

No Logs Found

未找到日志

Deployment may be too old (log retention limits) or service hasn't produced output.

部署可能过于陈旧（受日志保留限制），或者服务尚未生成任何输出。

railway-deployment

Original

Translation

Railway Deployment Management

Railway部署管理

When to Use

使用场景

List Deployments

列出部署

Specify Service

指定服务

View Logs

查看日志

Deploy Logs

部署日志

Build Logs

构建日志

Logs for Failed/In-Progress Deployments

失败/进行中部署的日志

Filter Logs

过滤日志

Errors only

仅显示错误

Text search

文本搜索

Combined

组合过滤

Time-Based Filtering

基于时间的过滤

Logs from last hour

最近1小时的日志

Logs between 30 and 10 minutes ago

30分钟到10分钟前的日志

Logs from specific timestamp

特定时间戳的日志

Logs from Specific Deployment

特定部署的日志

Redeploy

重新部署

Restart Container Only

仅重启容器

Remove Deployment

移除部署

Remove deployment for linked service

移除关联服务的部署

Remove deployment for specific service

移除特定服务的部署

CLI Options

CLI选项

deployment list

deployment list

logs

logs

redeploy

redeploy

restart

restart

down

down

Presenting Logs

日志展示建议

Composability

组合使用

Error Handling

错误处理

No Service Linked

未关联服务

No Deployments Found

未找到部署

No Logs Found

未找到日志