概述
感谢您对腾讯云云函数(Serverless Cloud Function,SCF)的支持。为聚焦核心产品能力、提供更清晰简化的使用体验,我们将于2027年1月1日00:00(UTC+8)起,对已停止官方维护的旧运行时及部分功能停止新建。不在本次调整范围内的运行时、功能与资源不受任何影响。
时间 | 影响 |
2027年1月1日 00:00(UTC+8)起 | 停止新建相关函数或应用。已创建的存量资源可继续运行与使用;其中,Serverless 应用的部署、更新及管理方式涉及调整,具体请参见下文迁移指引。 |
调整范围
调整功能 | 建议替代方案 |
Node.js 6.10、Node.js 8.9 运行时 | Node.js 16.13 或更高的受支持版本,建议优先评估 Node.js 20.19 |
Custom Runtime | 镜像函数 |
Serverless 应用 | SCF 控制台及关联资源所属产品控制台 |
AI 应用(图像生成) | 备份数据后自行部署图像生成方案 |
Agent 应用 | Agent Runtime |
K8s 资源托管模式 | 默认资源托管模式下的标准云函数 |
注意:
1. 本次调整停止新建相关函数或应用。已创建的存量资源可继续运行与使用;其中,Serverless 应用的部署、更新及管理方式涉及调整,具体请参见下文迁移指引。
2. Node.js 6.10 与 Node.js 8.9 已停止官方维护多年,存在已知安全漏洞且无法获得补丁,强烈建议存量函数尽早完成迁移。如后续对存量资源启动进一步限制,腾讯云将提前另行发布公告与通知,并预留充足的迁移窗口。
3. 未列入“调整范围”的运行时与功能,暂无下线计划,请放心使用。
如何确认自己是否受影响
1. 旧运行时函数:登录 Serverless 控制台 函数列表,按运行时筛选 Node.js 6.10、Node.js 8.9 或 Custom Runtime,即可列出受影响函数。
2. Serverless 应用、AI 应用或 Agent 应用:在控制台对应标签页查看存量实例。
3. K8s 资源托管模式:查看命名空间类型是否为 K8s 托管。
4. 我们将通过站内信、短信、邮件等方式分批通知已识别到的受影响用户。是否涉及本次调整,请以本指南列明的调整范围及您实际使用的功能为准。如未收到通知但使用了相关功能,可按上述方式核查,或提交工单确认。
时间轴
即日起:可参照本指南开始评估与迁移,如有疑问可随时提交工单。
2027年1月1日 00:00(UTC+8):停止新建生效;存量资源继续正常使用。
后续:如启动存量资源进一步限制,将另行公告并预留充足迁移窗口。
迁移前准备
迁移前,请完成以下准备:
1. 盘点函数、应用、触发器、网络、环境变量、层、日志、监控和计费资源。
2. 导出代码、配置文件、依赖清单、应用编排文件和必要的业务数据。
3. 在非生产环境创建目标资源,并完成兼容性和性能测试。
4. 配置调用量、错误率、运行耗时和资源消耗等监控告警。
5. 制定灰度切流和回滚方案。迁移完成后保留原资源至少 7 天,确认目标资源稳定后再清理。
迁移 Node.js 运行时
版本差异
Node.js 6.10 和 Node.js 8.9 已停止官方维护。迁移前请重点检查以下差异:
差异项 | 迁移建议 |
平台内置依赖 | Node.js 14.18 及之后版本不再额外内置依赖库(腾讯云 SDK 等),请在 package.json 中显式声明全部依赖,否则函数将因找不到模块而报错。 |
第三方依赖兼容性 | Node.js 大版本跳跃可能导致部分老旧依赖(如 node-sass、老版本 bcrypt/grpc 等原生模块)在新版本下编译失败,请提前在目标版本环境重新安装验证,必要时更换维护中的替代库。 |
Buffer API | 将已废弃的 new Buffer() 替换为 Buffer.from() 或 Buffer.alloc()。 |
URL API | 将旧代码中的 url.parse() 逐步迁移至 WHATWG URL API。 |
Promise 异常 | 补充 Promise 异常处理,避免未处理的 rejection 导致进程退出。 |
原生扩展 | 在目标 Node.js 版本和 SCF 运行环境兼容的平台上重新安装或编译。 |
操作步骤
1. 登录 Serverless 控制台,进入函数服务页面。
2. 新建函数,选择 Node.js 16.13 或更高的受支持版本。函数类型、地域、命名空间、内存、超时时间和网络配置应与原函数保持一致。
3. 复制原函数代码,并在
package.json 中声明所有运行依赖。建议优先评估 Node.js 20.19。4. 在与目标运行时一致的本地环境重新安装依赖并构建部署包。
5. 使用原函数的测试事件调用新函数,对比返回结果、日志、错误率和运行耗时。
6. 通过别名或上游调用配置将少量非核心流量切换至新函数。验证通过后逐步扩大流量,直至完成全量迁移。
7. 观察新函数至少 24 - 48 小时。确认业务稳定后,再评估是否清理原函数。
回滚建议
切流期间保留原函数及其触发器配置。出现兼容性、性能或依赖异常时,将流量切回原函数,并根据日志修复新函数后再次验证。
迁移 Custom Runtime
方案说明
镜像函数将运行环境、依赖和代码封装为容器镜像,覆盖 Custom Runtime 的自定义语言、框架及系统依赖场景。镜像函数支持 WebServer 和 Job 等类型,请根据原函数的调用方式选择目标类型。
迁移前请注意三点差异
1. 事件获取方式不同:Custom Runtime 通过
bootstrap 中的运行时 API 长轮询拉取事件;WebServer 镜像函数需在镜像内运行一个 HTTP 服务,监听 SCF 指定端口,由平台将事件转发至该服务。请将长轮询逻辑改造为 HTTP 服务,具体端口与请求格式以 WebServer 镜像接入文档为准。2. 层(Layer)支持差异:镜像函数对层的支持与代码包函数存在差异。原 Custom Runtime 使用的层依赖请评估打入镜像,迁移前请确认所需层能力在镜像形态下的替代方式。
3. 冷启动差异:镜像函数的冷启动耗时随镜像大小增长。请控制镜像体积(精简基础镜像、清理构建缓存),并在性能测试阶段重点验证冷启动与启动耗时是否满足业务要求。
操作步骤
1. 盘点原 Custom Runtime 的
bootstrap、运行时依赖、环境变量、层、网络和触发器配置。2. 编写 Dockerfile,将运行环境、代码和依赖打包到镜像中。
3. 如果选择 WebServer 镜像函数,请将原运行时 API 长轮询逻辑改造为 HTTP 服务,并监听 SCF 要求的端口。
4. 在本地构建并运行镜像,使用与生产事件等价的请求验证返回结果。
5. 将镜像推送至与函数同地域的腾讯云容器镜像服务仓库。
6. 在 SCF 控制台创建镜像函数,配置镜像、启动命令、资源规格、环境变量、网络和日志。
7. 使用测试事件或测试请求验证函数启动、调用和日志。重点关注启动耗时、端口监听和依赖加载。
8. 先切换非核心流量,再逐步完成全量迁移。确认稳定后再清理原 Custom Runtime 函数。
回滚建议
为镜像使用不可变版本标签,并保留上一稳定版本。新镜像出现异常时,将函数配置或上游流量回滚至上一稳定版本。
迁移 Serverless 应用
方案说明
Serverless 应用创建的函数资源运行在 SCF 上。停止新建应用后,您可以继续在 SCF 控制台管理存量函数,并在对应产品控制台管理 API、对象存储和层等关联资源。
关于 Serverless Framework CLI
如您通过 Serverless Framework CLI(
sls deploy)部署和管理应用:2027年1月1日起,通过 CLI 新建应用同样停止。新版 CLI 将直接封堵相关能力;未更新 CLI 的旧版本用户,将在云 API 侧被拦截并收到对应错误提示,建议提前升级至最新版本 CLI。存量应用内的函数可继续运行和使用。Serverless 应用的部署、更新及管理方式将调整:函数代码与配置可通过 SCF 控制台、云 API 或 SDK 管理;API、对象存储等关联资源请在对应产品控制台管理。原有的 serverless.yml 等编排文件请保留作为配置备份,后续不再作为部署入口使用。操作步骤
1. 打开存量 Serverless 应用,记录应用包含的函数、触发器、API、对象存储桶、层、环境变量和命名空间。
2. 登录 SCF 控制台,在对应地域和命名空间查找应用创建的函数。函数无需重复创建。
3. 在各资源所属产品控制台确认 API、对象存储桶和其他关联资源可正常管理。
4. 将后续函数代码发布改为通过 SCF 控制台、云 API 或 SDK 完成,并在函数详情中维护触发器和环境变量。
5. 选取非核心应用验证完整调用链路。对比迁移前后的函数日志、触发器执行结果和 API 路由。
6. 验证通过后,逐一迁移其他应用的管理流程,并保留原编排文件作为配置备份。
回滚建议
迁移验证期间不删除原应用和编排文件。若直接管理方式出现配置遗漏,请根据原编排文件恢复环境变量、触发器或关联资源配置。
迁移 AI 应用
方案说明
图像生成应用停止新建后,已部署的 StableDiffusionWebUi、ComfyUI 等实例可继续使用。该场景暂无统一的官方替代产品,建议先完成数据备份,再根据业务需求评估自行部署方案。
如需自行部署,可参考以下方向:**GPU 云服务器(CVM GPU 机型)**适合快速还原单机部署形态;TKE GPU 节点适合需要弹性伸缩与多实例管理的场景。两者均可直接部署 Stable Diffusion WebUI 与 ComfyUI 官方版本。
备份步骤
1. 记录已部署应用的 GPU 规格、并发配置、网络、存储和启动参数。
2. 导出 StableDiffusionWebUi 或 ComfyUI 使用的自定义模型、插件、自定义节点和依赖清单。
3. 下载已生成的图片及其他业务输出,并将重要数据保存至对象存储 COS 或本地持久化存储。
4. 导出 ComfyUI 工作流 JSON、提示词模板和其他业务配置。
5. 在目标环境恢复模型、节点、依赖和配置,使用代表性任务验证生成结果、耗时和显存占用。
6. 完成业务切流,并保留原实例用于回滚。确认目标环境稳定后再清理原资源。
注意事项
自定义模型文件可能较大,请预留足够的存储空间和传输时间。
备份完成后应校验文件完整性,并在目标环境完成恢复演练。
如果不再使用 GPU 预付费资源,请先确认资源依赖,再根据计费规则评估退费。
迁移 Agent 应用
方案说明
全新升级的 Agent Runtime 提供更完善的 Agent 沙箱、工具与 API Key 管理能力,是 Agent 应用的官方演进方向。迁移时可根据原 Agent 应用使用的运行时、浏览器沙箱、代码沙箱和 MCP 工具,分别映射至 Agent Runtime 的对应能力。
注意:
Agent Runtime 为独立产品,计费模式与 SCF 存在差异,建议先参考其计费文档评估成本变化。
操作步骤
1. 盘点原 Agent 应用使用的运行时、沙箱、工具、模型、网络、存储和权限配置。
2. 在 Agent Runtime 控制台创建并妥善保存 API Key。
3. 根据原应用能力创建代码沙箱、浏览器沙箱或其他所需资源,并配置工具和访问权限。
4. 修改调用方的鉴权和接口配置,将原 SCF 鉴权方式切换为 Agent Runtime API Key。
5. 在测试环境验证 Agent 运行、沙箱启动、工具调用、文件读写和异常处理。
6. 先迁移非核心流量,再逐步完成全量迁移。迁移期间持续观察调用成功率、运行耗时和资源消耗。
7. 确认所有 Agent 应用迁移完成后,再清理原实例和不再使用的凭据。
安全建议
API Key 仅保存在服务端或密钥管理系统中,不要写入客户端代码、日志或公开仓库。迁移完成后,请及时停用不再使用的凭据。
迁移 K8s 资源托管模式
方案说明
K8s 资源托管模式使用用户自有 TKE 集群运行函数。迁移至默认资源托管模式后,函数由 SCF 平台托管,并按标准云函数计费规则计费。
操作步骤
1. 盘点 K8s 命名空间下的函数、代码、运行时、资源规格、环境变量、层、触发器、网络和权限配置。
2. 在
default 或其他非 K8s 命名空间中重建函数,并保持业务配置一致。3. 重建定时、COS 等触发器。对于已停止服务或不再支持新建的触发器,请选择当前可用的替代方案。
4. 使用原测试事件验证新函数返回结果,并对比日志、错误率和运行耗时。
5. 将部分非核心上游流量切换至新函数。验证通过后逐步完成全量迁移。
6. 确认新函数稳定运行 24 - 48 小时,并核对计费变化。
7. 完成业务和配置备份后,再删除原函数及不再使用的 K8s 命名空间资源。
注意事项
两种资源托管模式的计费方式不同,请在迁移前结合实际业务用量和资源配置评估成本。
原命名空间中的 VPC 子网、节点选择等 K8s 专属配置不能直接迁移,请根据标准云函数能力重新配置。
如果业务依赖自有集群的特殊网络或调度能力,请先 提交工单 评估迁移方案。
迁移验证
完成任一迁移后,请至少验证以下项目:
验证项 | 验证内容 |
功能 | 请求、事件处理和返回结果符合预期。 |
性能 | 冷启动、运行耗时、并发和超时符合业务要求。 |
稳定性 | 错误率、重试、日志和告警无异常。 |
安全 | 权限、网络、密钥和敏感信息配置符合要求。 |
成本 | 计费模式、资源规格和实际费用符合预期。 |
回滚 | 原资源、配置备份和切回路径可用。 |
计费与退费
本次调整不会自动删除存量资源,也不会自动停止计费。如果您因迁移不再使用相关付费资源,请先确认资源依赖,再根据对应规则申请退费:
套餐包退费请参见 套餐包(预付费)。
资源包退费请参见 资源包(预付费)。
实际退费条件和金额以退款申请审核结果为准。