SuperAPI AI 工具集

railway-deploy

部署与运维

查看项目

更新于 10-15 11:57

技能介绍

Railway Deploy 是一个面向 Railway 平台的部署技能,用于将当前目录中的代码通过 railway up 命令部署到 Railway。

用途 该技能在用户要求部署、推送代码,或明确说出“railway up”“deploy”“ship”“push”等指令时使用。它主要解决将本地代码变更部署到 Railway 的需求,也支持“部署并修复问题”这类需要观察构建过程的场景。

主要能力 技能提供两种部署模式。默认的分离模式(Detach Mode)使用 railway up --detach,启动部署后立即返回,适合大多数部署场景。CI 模式使用 railway up --ci,会流式输出构建日志直到完成,适合用户希望观察构建过程、调试构建失败或查看构建输出的情况。

技能支持部署到指定服务,默认使用已链接的服务,可通过 --service 指定其他服务,例如 railway up --detach --service backend。也支持部署到未链接的项目,需要同时提供 --project 和 --environment 参数,例如 railway up --project <project-id> --environment production --detach。

CLI 选项 技能列出了可用的命令行选项:-d 或 --detach 表示不附加日志(默认);-c 或 --ci 表示流式输出构建日志并在完成后退出;-s 或 --service <NAME> 指定目标服务(默认已链接服务);-e 或 --environment <NAME> 指定目标环境(默认已链接环境);-p 或 --project <ID> 指定目标项目(需要配合 --environment);[PATH] 指定部署路径(默认当前目录)。

目录链接 Railway CLI 会沿目录树向上查找已链接的项目。如果当前处于已链接项目的子目录中,无需重新链接。对于子目录部署,建议先通过 railway-environment 技能设置 rootDirectory,然后正常使用 railway up 部署。

部署之后 在分离模式下,部署启动后会显示“Deploying to <service>...”,此时可使用 railway-deployment 技能检查构建状态(配合 --lines 参数)。在 CI 模式下,构建日志会内联流式输出,如果构建失败,错误会出现在输出中。注意不要在 CI 模式后运行 railway logs --build,因为日志已经流式输出过;如需更多上下文,可使用 railway-deployment 技能并配合 --lines 参数(不要流式输出)。

可组合性 部署后检查状态可使用 railway-service 技能;查看日志可使用 railway-deployment 技能;修复配置问题可使用 railway-environment 技能;配置修复后重新部署也可使用 railway-environment 技能。

错误处理 如果未链接项目,会提示“No Railway project linked. Run railway link first.”。如果未链接服务,会提示“No service linked. Use --service flag or run railway service to select one.”。在 CI 模式下构建失败时,构建日志已经流式输出,应直接从 railway up --ci 的输出中分析,不要在 CI 模式后运行 railway logs(它会无限流式输出且没有 --lines)。常见问题包括:缺少依赖,需检查 package.json 或 requirements.txt;构建命令错误,可使用 railway-environment 技能修复;Dockerfile 问题,需检查 Dockerfile 路径。

适用场景 该技能适用于需要将本地代码部署到 Railway 的开发者,尤其是使用 Claude Code 等工具进行自动化部署的场景。它适合快速部署、观察构建过程、调试构建失败、部署到指定服务或环境,以及部署到未链接项目等需求。

限制 该技能依赖 Railway CLI 和已链接的项目或服务。部署到未链接项目时必须同时提供 --project 和 --environment 参数。CI 模式后不应再运行 railway logs --build。关于收费、价格、平台支持范围等更多信息,资料中暂未提供。