用途:在腾讯云 CloudBase Run(云托管)上初始化、运行、部署、检查或调试后端服务,适用于需要长连接(WebSocket、SSE、服务端推送)、自定义系统依赖或任意语言运行时、VPC 内数据库/Redis 访问、Agent 服务,以及迁移已有容器化或第三方应用的场景。
主要能力:提供 Function 模式与 Container 模式的选型规则;给出「云托管 vs HTTP 云函数」决策原则(HTTP 云函数优先,有 Dockerfile 不等于必须上云托管);提供数据库访问方式决策门(能用 SDK/网关访问的数据优先 SDK,仅迁移类应用走 TCP 直连 + VpcConf);提供计算资源访问 CloudBase 的凭证决策门(谁签发、怎么注入、怎么吊销);并给出部署失败、日志查询、发布任务状态的排查流程。
使用方式:先显式选择 Function 模式或 Container 模式。Container 模式须监听注入的 PORT,Function 模式由框架绑定端口,代码不得调用 app.listen()。首次部署前须确认环境已初始化 CloudRun,可调用 manageCloudRun(action="initEnv") 并用 queryCloudRun(action="envStatus") 轮询。读操作走 queryCloudRun,写操作走 manageCloudRun,删除需显式确认并 force: true,路径使用绝对路径。凭证应通过 manageAppAuth(action="createApiKey", keyType="api_key") 签发并经 EnvParams 注入 CLOUDBASE_APIKEY,不得从本地登录态复制。
限制:服务须保持无状态,持久数据外置;Container 模式不支持本地运行;不要部署 httpbin 类回显镜像或回显 x-cloudbase-context、完整请求头、凭证环境变量;镜像部署失败应查 getProcessLog 而非 getDeployLog;不要用已废弃的 tcb CloudRun 小租户 API。资料未提供具体价格、配额与完整命令示例。