用途
render-deploy 用于将应用部署到 Render 云平台。它通过分析代码库、生成 render.yaml Blueprint 文件,并提供 Render Dashboard 深链接,帮助用户完成部署。适用于用户希望将应用部署到 Render、创建 render.yaml Blueprint、为项目设置 Render 部署、在 Render 云平台托管或发布应用,以及创建数据库、定时任务或其他 Render 资源等场景。
主要能力
该技能覆盖 Git 支持的部署流程,包括两种方法:
- Blueprint 方法:生成 render.yaml 用于基础设施即代码(IaC)部署。适合多服务应用、IaC 工作流,具有版本控制、可复现、支持复杂配置等优点。
- 直接创建方法:通过 MCP 工具即时创建服务。适合单个服务、快速部署,无需 render.yaml 文件。
Blueprint 也可以通过 runtime: image 运行预构建的 Docker 镜像,但 render.yaml 仍必须位于 Git 仓库中。
技能包含方法选择启发式规则:当满足单一服务、无独立 worker/cron、无附加数据库或 Key Value、仅简单环境变量等全部条件时,使用直接创建(MCP);当存在多服务、需要数据库/Redis/Key Value、定时任务/后台 worker/私有服务、需要可复现 IaC 或 monorepo/多环境配置等任一条件时,使用 Blueprint。若不确定,默认使用 Blueprint 以确保安全。
使用方式
前置条件检查
按顺序验证:确认源路径(Git 还是 Docker);检查 MCP 工具可用性(尝试 list_services());检查 Render CLI 安装(render --version,未安装可提供安装命令);MCP 设置(若未配置,询问用户是否设置 MCP 或使用 CLI 回退);检查认证(CLI 回退时使用 render whoami -o json);检查工作区上下文(get_selected_workspace() 或 render workspace current -o json)。
Blueprint 部署流程
- 分析代码库,确定框架/运行时、构建和启动命令、所需环境变量、数据存储和端口绑定。
- 生成 render.yaml Blueprint 文件,遵循 Blueprint 规范。关键点:除非用户指定,始终使用 plan: free;包含应用所需的所有环境变量;用 sync: false 标记机密(用户在 Dashboard 填写);使用适当的服务类型(web、worker、cron、static、pserv)和运行时。
- 立即提供后续步骤清单并运行验证:认证(render whoami -o json)、验证(render blueprints validate)、提交并推送(git add render.yaml && git commit -m "Add Render deployment configuration" && git push origin main)、打开 Dashboard、填写机密、部署。
- 验证配置,修复常见问题(缺少必填字段、无效运行时值、YAML 语法错误、无效环境变量引用)。
- 提交并推送 render.yaml 到 Git 远程仓库。
- 生成 Dashboard 深链接:https://dashboard.render.com/blueprint/new?repo=<REPOSITORY_URL>。
- 指导用户:确认 render.yaml 已合并、点击深链接、完成 Git OAuth、命名 Blueprint、填写机密环境变量、审查配置、点击 "Apply" 部署。
- 验证部署:通过 MCP 检查部署状态(list_deploys)、检查运行时错误(list_logs)、检查服务健康指标(get_metrics)。
直接创建流程
- 分析代码库。
- 通过 MCP 创建资源(web 或 static 服务及所需数据库或键值存储)。
- 配置环境变量。
- 验证部署(检查部署状态、日志和指标)。
部署后验证与基本排查
确认最新部署已上线并服务流量;访问健康端点(或根路径)验证 200 响应;扫描最近错误日志寻找明确失败特征;验证所需环境变量和端口绑定(0.0.0.0:$PORT)。
适用场景
- 将应用部署到 Render 云平台
- 创建 render.yaml Blueprint 文件
- 为项目设置 Render 部署
- 在 Render 云平台托管或发布应用
- 创建数据库、定时任务或其他 Render 资源
- 多服务应用、IaC 工作流、monorepo 或多环境配置
- 单个服务的快速原型或演示部署
限制
- Git 支持的流程要求仓库已推送到 GitHub、GitLab 或 Bitbucket。若没有 Git 远程仓库,需停止并请用户创建/推送远程仓库,或改用 Render Dashboard/API 部署预构建 Docker 镜像。
- MCP 不支持创建镜像支持的服务,预构建 Docker 镜像部署需使用 Dashboard/API。
- 当沙箱阻止部署网络调用时,需使用 sandbox_permissions=require_escalated 重新运行。
- 部署可能需要几分钟,需使用适当的超时值。
- 关于收费、价格、平台支持的具体细节,资料中暂未提供。