SuperAPI AI 工具集

railway-service

设计与创作

查看项目

更新于 10-15 20:34

技能介绍

用途:管理 Railway 平台上的服务,包括查看状态、更新属性以及高级的服务创建。适用于用户询问服务状态、健康度或部署情况,想重命名服务、更换图标、切换关联服务,或用 Docker 镜像部署新服务。注意:用本地代码创建服务(常见场景)应优先使用 railway-new 技能,它一并处理项目初始化、脚手架与服务创建。GitHub 仓库来源的做法是先用 railway-new 创建空服务,再用 railway-environment 技能通过 staged changes API 配置 source.repo。

主要能力与用法: 查看状态:railway status --json 获取 project.id、environment.id、service.id;railway service status --json 返回当前部署状态;railway deployment list --json --limit 5 查看部署历史。状态值包括 SUCCESS、FAILED、DEPLOYING、BUILDING、CRASHED、REMOVED。 创建服务:无 CLI 命令,需用 GraphQL 的 serviceCreate 变更,输入字段含 projectId(必填)、name、source.image、source.repo、branch、environmentId。示例:${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh 配合 mutation createService。创建后需用 railway-environment 技能配置实例,务必带上 isCreated: true,再应用并部署。 更新服务:用 serviceUpdate 变更修改 name 或 icon,图标可为图片 URL、动图 GIF 或 https://devicons.railway.app/{query} 提供的开发者图标。 关联服务:railway service link 或 railway service link <service-name>。

限制与错误处理:创建服务需至少 DEVELOPER 角色;Docker 镜像须可访问(公开或带仓库凭据);未关联服务、无部署、服务或项目不存在、权限不足、镜像无效等情况均有对应提示。删除服务、配置变量与命令、查看日志、部署本地代码分别由 railway-environment、railway-deployment、railway-deploy 等技能负责。