Railway CI/CD 自动化技能，用于通过 CI/CD 流水线、迁移脚本和事件驱动工作流实现 Railway 部署的自动化。
一、用途 该技能面向需要在持续集成/持续交付环境中自动化 Railway 部署的场景，包括配置部署触发器、跨环境发布、迁移既有平台服务、执行定时任务以及基于 Webhook 的事件驱动操作。
二、主要能力
- GitHub Actions 集成：支持生成 Railway 令牌、配置仓库 Secret、创建工作流文件并设置部署触发器；适用场景包括推送到 main/staging 分支时部署、PR 预览环境、多环境晋级、定时部署与手动审批门禁。
- GitLab CI 集成：支持在多阶段流水线（test → staging → production）、按环境部署、合并请求预览应用、并行服务部署与基于制品的部署等场景中使用。
- 自定义 CI/CD 集成：提供通用模式，通过安装 @railway/cli、使用令牌登录、链接项目并执行部署命令完成集成；支持 CircleCI、Travis CI、Jenkins、Bitbucket Pipelines、Azure DevOps 以及任何具备 shell 访问能力的平台。相关环境变量包括 RAILWAY_TOKEN、RAILWAY_PROJECT_ID、RAILWAY_SERVICE、RAILWAY_ENVIRONMENT，并提供部署后健康检查模式。
- 迁移自动化：提供交互式迁移脚本，支持从 Heroku、Vercel、Render 迁移，并包含 Docker Compose → Railway、Kubernetes → Railway 的迁移说明。脚本功能包括平台检测、环境变量导出/导入、Railway 项目创建、服务配置、数据库迁移、DNS 切换规划与验证检查，并支持 --dry-run 预览变更。
- 定时任务：支持基于 cron 的部署、数据库备份（如 pg_dump 后上传至 S3）与健康检查监控（如定时 curl 健康端点并在失败时通知）。
- Webhook 集成：支持 GitHub Webhook 触发 Railway 部署，Railway 侧可订阅部署开始、完成、失败、服务崩溃、构建日志等事件；可通过 CLI 或 API 配置 Webhook，并可与 Slack 等通知渠道集成。
三、使用方式 通过令牌认证：使用 railway login && railway token 生成令牌，并在各 CI 平台的 Secret/变量配置中加入 RAILWAY_TOKEN。通用部署流程为安装 CLI（npm i -g @railway/cli）、设置 RAILWAY_TOKEN、执行 railway link $PROJECT_ID，然后运行 railway up --service $SERVICE_NAME --environment $ENVIRONMENT。文档提供 GitHub Actions 与 GitLab CI 的流水线示例、多环境部署、PR 预览、失败回滚、矩阵并行部署等常见模式。
四、适用场景 适用于需要将 Railway 部署纳入自动化流水线的团队，包括多环境发布、预览环境、平台迁移、定时备份与健康监控、事件驱动的通知与部署联动等。
五、限制与注意事项 该资料未说明具体收费、价格或平台特性限制。文档给出的安全与可靠性建议包括：使用被掩码/受保护的 CI 变量、定期轮换令牌、生产环境使用服务令牌而非个人令牌、不将令牌提交到 git、限制令牌作用域；同时在部署前运行测试、使用健康检查、始终保留回滚机制并设置部署超时。故障排查部分覆盖 CI 部署失败、令牌认证错误、环境未找到、服务未部署等情况，可通过 railway whoami、railway status、railway list、railway logs 等命令排查。
六、配套资源 提供 references/github-actions.md（含 5+ 工作流示例）、references/gitlab-ci.md、references/migration-patterns.md，以及 templates/github-workflow.yml、templates/gitlab-ci.yml 与 scripts/migrate.sh。相关技能包括 railway-auth、railway-api、railway-deployment、railway-database、railway-monitoring。