用途:CloudBase Run(云托管)后端服务开发与部署规则,适用于需要常驻后端服务的场景,如 WebSocket/SSE 长连接、自定义系统依赖或任意语言运行时、VPC 内数据库/Redis 访问、Agent 服务、迁移已有或第三方容器化应用。若只是无状态 HTTP 服务、短生命周期请求、标准运行时,应优先选择 HTTP 云函数;有 Dockerfile 并不等于必须用云托管。
主要能力与要点:明确区分 Function mode 与 Container mode——前者由框架绑定平台端口,代码不得调用 app.listen();后者必须监听注入的 PORT,且需要 Dockerfile,本地运行工具不支持 Container mode。服务应保持无状态,持久数据放数据库/存储/缓存;资源建议 Mem = 2 × CPU。
两类决策门:一是数据库访问方式,能用 CloudBase SDK/网关(PG app.rdb()、NoSQL、storage)就优先 SDK,无需 VpcConf 和数据库账号密码;仅迁移类应用保留经典驱动/ORM 时才走 TCP 直连并配置 serverConfig.VpcConf。二是计算资源访问 CloudBase 的凭证,需先定签发、注入与吊销:用 manageAppAuth(action="createApiKey", keyType="api_key") 签发服务端 API Key,经 serverConfig.EnvParams 注入 CLOUDBASE_APIKEY,切勿从本地登录态复制。
使用方式:读操作走 queryCloudRun,写操作走 manageCloudRun,删除需显式确认并 force: true,路径用绝对路径。首次部署前须确保环境已初始化 CloudRun(manageCloudRun(action="initEnv")),未初始化环境会被拦截。部署失败时按顺序排查:先看文档,再看 getProcessLog 运行日志,最后查配置;镜像部署跳过 getDeployLog,改用 getProcessLog。
限制:不得回显 x-cloudbase-context、完整请求头或凭证环境变量;不要部署 httpbin 类反射服务;不要假设容器自带可用凭证,需实际调用 SDK 验证。具体收费、价格与更多平台细节暂未提供。