SuperAPI AI 工具集

render-automation

部署与运维

查看项目

更新于 10-15 11:24

技能介绍

用途

Render Automation 用于通过 Rube MCP 自动化 Render 云平台的操作。它基于 Composio 的 Render 工具包,让用户以工具调用的方式管理 Render 上的服务、部署和项目,而无需手动在控制台逐项操作。

主要能力

  • 列出与浏览服务:支持按名称子串、服务类型筛选,并支持游标分页。服务类型包括 web_service、static_site、private_service、background_worker、cron_job。
  • 触发部署:可对指定服务触发新的部署,并可选在部署前清除构建缓存。
  • 监控部署状态:可查询部署详情与状态,状态包括 created、build_in_progress、update_in_progress、live、deactivated、build_failed、update_failed、canceled。
  • 管理项目:可列出 Render 项目,项目用于将相关服务分组,支持游标分页。

使用方式

前置条件:

  • Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用)。
  • 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Render 连接,工具包为 render。
  • 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

设置步骤:

  1. 获取 Rube MCP:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥,添加端点即可使用。
  2. 确认 RUBE_SEARCH_TOOLS 有响应,以验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS,工具包为 render。
  4. 若连接不是 ACTIVE,按返回的授权链接完成 Render 认证。
  5. 确认连接状态为 ACTIVE 后再运行任何工作流。

核心工作流:

  1. 列出与浏览服务
  • 使用场景:查找或检查 Render 服务。
  • 工具序列:RENDER_LIST_SERVICES(必需)。
  • 关键参数:name(按名称子串筛选)、type(按服务类型筛选)、limit(每页最大结果数,默认 20,最大 100)、cursor(上一响应中的分页游标)。
  • 注意事项:服务类型必须使用精确枚举值;分页为游标式,需持续跟随 cursor 直到不存在;名称筛选为子串匹配而非精确匹配;服务 ID 格式为 srv-xxxxxxxxxxxx;默认 limit 为 20,如需完整列表应调高。
  1. 触发部署
  • 使用场景:手动部署或重新部署服务。
  • 工具序列:RENDER_LIST_SERVICES(前置,用于找到服务)、RENDER_TRIGGER_DEPLOY(必需)、RENDER_RETRIEVE_DEPLOY(可选,用于监控进度)。
  • 关键参数:TRIGGER_DEPLOY 需要 serviceId(格式 srv-xxxxxxxxxxxx),可选 clearCache(设为 true 在部署前清除构建缓存);RETRIEVE_DEPLOY 需要 serviceId 和 deployId(格式 dep-xxxxxxxxxxxx)。
  • 注意事项:serviceId 为必填,需先通过 LIST_SERVICES 解析;服务 ID 以 srv- 开头,部署 ID 以 dep- 开头;clearCache 为 true 会强制干净构建,耗时更长但可解决缓存相关问题;部署是异步的,需用 RETRIEVE_DEPLOY 轮询状态;在另一个部署进行中触发部署可能会排队。
  1. 监控部署状态
  • 使用场景:检查部署进度或结果。
  • 工具序列:RENDER_RETRIEVE_DEPLOY(必需)。
  • 关键参数:serviceId(必需)、deployId(必需)。
  • 响应包含 status、createdAt、updatedAt、finishedAt、commit。
  • 注意事项:两个参数均为必填;live 表示部署成功;build_failed 或 update_failed 表示部署出错;轮询间隔建议 10-30 秒以避免触发速率限制。
  1. 管理项目
  • 使用场景:列出和整理 Render 项目。
  • 工具序列:RENDER_LIST_PROJECTS(必需)。
  • 关键参数:limit(每页最大结果数,最大 100)、cursor(上一响应中的分页游标)。
  • 注意事项:项目用于将相关服务分组;分页为游标式;项目 ID 用于组织目的;并非所有服务都会分配到项目。

常见模式:

  • ID 解析:服务名到服务 ID,先调用 RENDER_LIST_SERVICES 并传入 name,在结果中找到服务并提取 id。部署查找,先保存 RENDER_TRIGGER_DEPLOY 返回的 deployId,再用 serviceId 和 deployId 调用 RENDER_RETRIEVE_DEPLOY 检查状态。
  • 部署并监控模式:LIST_SERVICES 找到服务并获取 serviceId,TRIGGER_DEPLOY 获取 deployId,循环调用 RETRIEVE_DEPLOY,live 为成功,build_failed/update_failed 为错误,持续轮询直到终态。
  • 分页:使用响应中的 cursor 获取下一页,直到 cursor 不存在或结果为空;LIST_SERVICES 和 LIST_PROJECTS 均使用游标分页;将 limit 设为最大 100 可减少分页轮次。

适用场景

  • 需要以脚本或工具调用方式批量查看 Render 服务与项目。
  • 需要手动触发部署并跟踪部署结果。
  • 需要将 Render 操作集成到基于 MCP 的自动化流程中。

限制与注意事项

  • 依赖 Rube MCP 连接和有效的 Render 授权,连接状态必须为 ACTIVE。
  • 每次操作前应先调用 RUBE_SEARCH_TOOLS 获取最新 schema。
  • 服务类型筛选必须使用精确枚举值。
  • 部署为异步,失败部署不会自动回滚,上一版本保持在线。
  • Render API 存在速率限制,应避免快速轮询,建议 10-30 秒间隔,批量操作需限流。
  • 响应数据可能嵌套在 data 键下,时间戳为 ISO 8601 格式,解析时应为可选字段提供回退。
  • 关于收费、价格、平台支持范围等未在资料中提供的信息,暂未提供。