Back to Details

railway-deploy

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Railway Deploy

Railway 部署

Deploy code from the current directory to Railway using 
railway up
.
使用
railway up
将当前目录的代码部署到Railway。

When to Use

使用场景

  • User asks to "deploy", "ship", "push code"
  • User says "railway up" or "deploy to Railway"
  • User wants to deploy local code changes
  • User says "deploy and fix any issues" (use --ci mode)
  • 用户要求“deploy”、“ship”、“推送代码”
  • 用户提到“railway up”或“部署到Railway”
  • 用户想要部署本地代码变更
  • 用户提到“部署并修复所有问题”（使用--ci模式）

Modes

模式

Detach Mode (default)

分离模式（默认）

Starts deploy and returns immediately. Use for most deploys.
bash
railway up --detach
启动部署后立即返回。适用于大多数部署场景。
bash
railway up --detach

CI Mode

CI模式

Streams build logs until complete. Use when user wants to watch the build or needs to debug issues.
bash
railway up --ci
When to use CI mode:
  • User says "deploy and watch", "deploy and fix issues"
  • User is debugging build failures
  • User wants to see build output
持续输出构建日志直到完成。当用户想要查看构建过程或需要调试问题时使用。
bash
railway up --ci
CI模式适用场景：
  • 用户要求“部署并查看”、“部署并修复问题”
  • 用户正在调试构建失败问题
  • 用户想要查看构建输出

Deploy Specific Service

部署到指定服务

Default is linked service. To deploy to a different service:
bash
railway up --detach --service backend
默认部署到已关联的服务。如需部署到其他服务：
bash
railway up --detach --service backend

Deploy to Unlinked Project

部署到未关联的项目

Deploy to a project without linking first:
bash
railway up --project <project-id> --environment production --detach
Requires both 
--project
and 
--environment
flags.
无需先关联即可部署到指定项目：
bash
railway up --project <project-id> --environment production --detach
需要同时使用
--project
和
--environment
参数。

CLI Options

CLI选项

FlagDescription
-d, --detach
Don't attach to logs (default)
-c, --ci
Stream build logs, exit when done
-s, --service <NAME>
Target service (defaults to linked)
-e, --environment <NAME>
Target environment (defaults to linked)
-p, --project <ID>
Target project (requires --environment)
[PATH]
Path to deploy (defaults to current directory)
参数说明
-d, --detach
不附加日志输出（默认模式）
-c, --ci
流式输出构建日志，完成后退出
-s, --service <NAME>
目标服务（默认使用已关联的服务）
-e, --environment <NAME>
目标环境（默认使用已关联的环境）
-p, --project <ID>
目标项目（需配合--environment使用）
[PATH]
部署路径（默认当前目录）

Directory Linking

目录关联

Railway CLI walks UP the directory tree to find a linked project. If you're in a subdirectory of a linked project, you don't need to relink.
For subdirectory deployments, prefer setting 
rootDirectory
via the railway-environment skill, then deploy normally with 
railway up
.
Railway CLI会向上遍历目录树查找已关联的项目。如果当前目录是已关联项目的子目录，无需重新关联。
如需部署子目录，建议通过railway-environment技能设置
rootDirectory
，然后使用
railway up
正常部署。

After Deploy

部署后操作

Detach mode

分离模式

Deploying to <service>...
Use railway-deployment skill to check build status (with 
--lines
flag).
正在部署到<service>...
使用railway-deployment技能查看构建状态（使用--lines参数）。

CI mode

CI模式

Build logs stream inline. If build fails, the error will be in the output.
Do NOT run 
railway logs --build
after CI mode - the logs already streamed. If you need more context, use railway-deployment skill with 
--lines
flag (never stream).
构建日志会实时流式输出。如果构建失败，错误信息会直接显示在输出中。
CI模式部署后请勿运行
railway logs --build
 - 日志已经实时输出过。如果需要更多上下文信息，请使用railway-deployment技能并配合--lines参数（请勿使用流式输出）。

Composability

技能组合

  • Check status after deploy: Use railway-service skill
  • View logs: Use railway-deployment skill
  • Fix config issues: Use railway-environment skill
  • Redeploy after config fix: Use railway-environment skill
  • 部署后查看状态：使用railway-service技能
  • 查看日志：使用railway-deployment技能
  • 修复配置问题：使用railway-environment技能
  • 配置修复后重新部署：使用railway-environment技能

Error Handling

错误处理

No Project Linked

未关联项目

No Railway project linked. Run `railway link` first.
未关联Railway项目，请先运行`railway link`。

No Service Linked

未关联服务

No service linked. Use --service flag or run `railway service` to select one.
未关联服务，请使用--service参数或运行`railway service`选择服务。

Build Failure (CI mode)

构建失败（CI模式）

The build logs already streamed - analyze them directly from the 
railway up --ci
output. Do NOT run 
railway logs
after CI mode (it streams forever without 
--lines
).
Common issues:
  • Missing dependencies → check package.json/requirements.txt
  • Build command wrong → use railway-environment skill to fix
  • Dockerfile issues → check dockerfile path
构建日志已实时输出 - 直接从
railway up --ci
的输出中分析错误。 CI模式部署后请勿运行
railway logs
（若无--lines参数，会一直流式输出）。
常见问题：
  • 缺少依赖项 → 检查package.json/requirements.txt
  • 构建命令错误 → 使用railway-environment技能修复
  • Dockerfile问题 → 检查Dockerfile路径