↑

CloudBase Run 后端服务开发助手v1.0.0

cloudbase-references-cloudrun-development5 KB

面向 CloudBase Run 后端部署场景,指导 Function 模式与容器模式的选择与开发。当你需要 WebSocket/SSE 长连接、多语言运行时、自定义容器环境,或基于 Function 模式开发 AI Agent 时触发。

0 0 0 0 更新于 2026-10-28 18:24

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 为 CloudBase Run 后端服务开发提供完整的模式决策、工程规范与工具调用指引。覆盖 Function 模式(快速起步、内置 HTTP/WebSocket/SSE、支持本地运行)与容器模式(任意语言运行时、需 Dockerfile)两种部署形态,明确端口监听、无状态设计、资源配比(Mem = 2 × CPU)、访问控制等硬性约束。同时内置 AI Agent 开发专项流程,支持基于 Function 模式快速搭建带 SSE 流式响应的个性化智能体应用,并配套 queryCloudRun 查询与 manageCloudRun 运维工具的完整调用示例。

技能包含

  • SKILL.md(本文件):技能主说明,含模式选择对照、开发强制要求、工具读写分离规范、核心工作流与最佳实践

核心能力

  • 模式智能决策:根据长连接需求、语言框架限制、本地调试需要,自动匹配 Function 模式或容器模式
  • 强制规范校验:确保服务监听 PORT 环境变量、无状态外置存储、无后台常驻进程、镜像最小化、资源配比合规
  • 工具链精准调用:区分 queryCloudRun 只读操作(列表/详情/模板)与 manageCloudRun 写入操作(初始化/下载/本地运行/部署/删除/创建 Agent),规范绝对路径与强制确认参数
  • AI Agent 快速搭建:基于 Function 模式,使用 @cloudbase/aiagent-framework 创建、运行带 SSE 流式响应的智能体,支持 normal 与 agent 双运行模式
  • 部署验证闭环:从项目初始化、Dockerfile 生成、本地运行到弹性扩缩容配置,提供可复现的六步工作流

应用场景

用户怎么说本技能做什么
"我要部署一个 WebSocket 实时推送服务"推荐 Function 模式,指导固定端口 3000 配置、SSE 流式响应实现,并给出 deploy 时开启 WEB 访问的完整参数
"现有 Java/Go/PHP 项目想上云,需要自定义系统依赖"切换容器模式,检查或生成对应 Dockerfile,约束镜像分层与体积,配置 PORT 环境变量注入
"想做一个能流式回复的 AI 客服机器人"启用 Agent 开发流程,通过 createAgent 初始化智能体项目,run 时指定 runMode: 'agent',对接 SSE 输出
"服务部署后访问不通,怎么排查"调用 queryCloudRun.detail 核查 OpenAccessTypes、域名、端口、实例是否缩容至 0,区分公网与内网 callContainer 接入方式
"需要最小成本保持服务常驻,有请求时再扩容"配置弹性伸缩参数 MinNum: 0、MaxNum 按需,结合资源配比公式 Mem = 2 × CPU 优化冷启动与费用