文档中心

函数服务

功能应用

使用函数实现 TOS 触发 CDN 刷新预热

本文为您介绍如何通过函数服务实现 TOS 触发 CDN 刷新/预热任务。

场景介绍

互联网应用大多采用动静分离架构，将视频、音频、图片、JS 脚本等静态资源放在对象存储（TOS）中，并使用 CDN 进行访问加速。若 TOS 的旧资源发生更新或升级，就需要及时更新节点已缓存内容，避免用户仍访问到旧的缓存资源。

CDN 提供刷新/预热功能，支持手动提交缓存刷新/预热任务。然而手动运维并不高效且容易出错，函数服务可以帮助您实现 TOS 变更自动触发 CDN 刷新/预热，极大地提高运维效率。

背景信息

CDN：内容分发网络（Content Delivery Network，CDN）面向内容提供商，针对其在互联网上传播的图片、音视频、网页、下载包等静态内容，提供传输加速服务，优化用户访问体验，提高下载速度。更多介绍请参见什么是内容分发网络。

预热：CDN 节点主动从源站拉取特定文件（一般是大文件，如视频文件、安装包文件等），并将文件缓存在节点上。这样当用户请求对应文件时，CDN 节点可以直接返回文件。该方式减少了节点从源站获取文件带来的延时，避免了用户同时请求大文件时源站下载压力过大。

前提条件

已添加您的站点域名作为加速域名，并将加速域名与您的 TOS Bucket 绑定（即将您的 TOS Bucket 作为加速域名的源站），具体操作可参见设置加速域名。

已获取 API 访问密钥（AK 和 SK），并确保该密钥具有 CDN 缓存预热（SubmitPreloadTask）、缓存刷新（SubmitRefreshTask）的操作权限。具体操作可参见 Access Key（密钥）管理和创建用户并授权。

使用限制

操作步骤

步骤一：使用代码模板创建函数

使用 vefaas-golang-cdn-refresh-preload 代码模板创建函数，并将代码需要获取的 AK 和 SK 等信息配置为环境变量。

配置项	说明
创建函数的方式	选择创建「事件函数」。
基础配置
名称	根据界面提示的命名规则，自定义函数名称。创建函数成功后名称不可修改。
函数代码
运行时	选择 Golang。
部署方式	选择函数模板 > vefaas-golang-cdn-refresh-preload。
高级配置
日志功能	启用日志功能，投递至默认日志集。
环境变量	需新增以下 4 条环境变量： CloudAPI_AccessKey：输入 API 访问密钥的 Access Key ID。 CloudAPI_SecretKey：输入 API 访问密钥的 Secret Access Key。 TOS_EVENT_TASK_KIND：输入要执行的任务类型。支持的取值如下： refresh：（默认值）文件刷新。 preload：文件预热。 BASE_URL_LIST：输入待执行任务的 URL，例如http://cdndomain1/,http://cdndomain2/,http://cdndomain3/。支持添加多个 URL，多个 URL 之间以英文逗号分隔。当 TOS 事件触发后，函数服务会将该列表中的每个 URL 拼接 TOS 文件名，作为最终刷新/预热 URL 提交给 CDN。

步骤二：发布函数

将函数的当前代码和配置发布至线上。

步骤三：配置 TOS 触发器

为当前函数配置 TOS 触发器，设置触发函数的规则。

配置项	说明
触发器类型	选择 TOS 触发器。
触发器名称	根据界面提示规则自定义触发器名称。
TOS Bucket	选择前提条件中准备的 TOS Bucket。
触发事件	本示例选择 tos:ObjectCreated:Put 和 tos:ObjectCreated:CompleteUpload。注意有大文件分片上传的情况下，需要同时选择 tos:ObjectCreated:Put 和 tos:ObjectCreated:CompleteUpload。若无分片上传的情况，可只选择 tos:ObjectCreated:Put，通过简单上传对象后触发。
过滤条件	通过设置过滤条件，可精确匹配需要监听的事件所包含的对象范围，有效降低触发频率，减少成本。本示例不设置。