SuperAPI AI 工具集

cloudrun-development

编程与开发

查看项目

更新于 10-16 05:46

技能介绍

用途:CloudBase Run 后端服务开发。适用场景包括长连接(WebSocket/SSE/服务端推送)、长时或常驻进程与后台任务、自定义镜像与系统依赖、多语言框架(Java/Go/PHP/.NET/Python/Node.js 等)、可缩容到 0 的弹性外部服务、VPC/PRIVATE 内网访问与小程序 callContainer 内网直连,以及基于函数模式的 AI 智能体开发。不适合简单云函数、纯前端应用和数据库表结构设计。

模式选择:函数模式上手最快,内置 HTTP/WebSocket/SSE,固定端口 3000,支持本地运行;容器模式支持任意语言运行时,需要 Dockerfile,工具不支持本地运行。

强制要求:监听 PORT 环境变量;服务无状态,数据写外部存储;请求外不得有常驻后台线程;精简依赖与镜像以降低冷启动;内存为 CPU 的 2 倍(如 0.25 vCPU 对应 0.5 GB);仅 Web 场景开启公网,小程序优先内网直连。

工具:只读用 queryCloudRun(list/detail/templates);写操作 use manageCloudRun(init/download/run/deploy/delete/createAgent)。targetPath 必须为绝对路径,删除需 force: true。

流程:初始化项目→容器模式检查或生成 Dockerfile→函数模式本地运行→配置访问方式→部署→用 detail 验证。调用方式含 HTTP 直连、小程序 wx.cloud.callContainer、Web JS SDK(初始化必须同步,使用顶层 import cloudbase from "@cloudbase/js-sdk")、Node.js @cloudbase/node-sdk callContainer。智能体使用 @cloudbase/aiagent-framework,BotId 格式为 ibot-{name}-{tag}。

限制与故障排查:本地运行仅支持函数模式;Dockerfile 需本地构建通过;访问失败检查 OpenAccessTypes、域名、端口与实例是否缩容到 0;部署失败检查构建日志、镜像体积与 CPU/内存比例;性能抖动可减少依赖并增大 MinNum。其他细节(如价格)暂未提供。