EdgeOne Logo
Documentation
请选择
请选择
Overview
Menu

快速指引

本文通过示例创建一个简单的函数,实现请求重定向到其他 URL 并返回自定义响应头,来向您介绍如何使用边缘函数。

示例场景

当前已将站点 example.com 接入 EdgeOne 服务,在该站点下,需通过自定义域名 www.example.com 为用户提供一个自定义的 HTML 活动页面,可通过边缘函数将该页面部署至 EdgeOne 的全球可用区边缘节点内供用户就近访问。
说明:
1. 如何接入站点可参考:从零开始快速接入 EdgeOne
2. 如何添加加速域名可参考:添加加速域名

操作步骤

步骤1:创建并部署函数

1. 登录 边缘安全加速平台 EO 控制台,在左侧菜单栏中,单击站点列表,在站点列表内单击需配置的站点
2. 在站点详情页面,单击边缘函数 > 函数管理
3. 在边缘函数管理页面,单击新建函数,选择使用模板创建函数,在此步骤您可以根据实际业务需求来使用模板创建一个函数。以当前场景为例,可选择使用“创建 Hello World” 模板新建。选择模板后,单击下一步
4. 在新建边缘函数页面,配置相关参数,参数说明如下:
函数名称:必填项,只能包含字母、数字、连字符,以字母开头,以数字或字母结尾,2~30个字符;创建后无法修改。如:test-edgefunctions。
描述:非必填,最多支持60个字符。如:自定义 HTML 页面和响应头。
函数代码:需响应的边缘函数代码内容。以当前场景为例,可复制如下函数代码,将其粘贴到控制台的代码编辑器中,替换编辑器中的默认代码。
const html = `
<!DOCTYPE html>
<body>
<h1>Hello World</h1>
<p>This markup was generated by TencentCloud Edge Functions.</p>
<a href="https://cloud.tencent.com/product/teo">TencentCloud EdgeOne</a>
</body>
`;

async function handleRequest(request) {
return new Response(html, {
headers: {
'content-type': 'text/html; charset=UTF-8',
'x-edgefunctions-test': 'Welcome to use Edge Functions.',
},
});
}

addEventListener('fetch', event => {
event.respondWith(handleRequest(event.request));
});
说明
上述代码的语义为自定义 HTML,并且添加自定义响应头 x-edgefunctions-test:Welcome to use Edge Functions。
5. 单击创建并部署,当弹窗如下对话框,即表示部署成功。



步骤2:配置触发规则

如期望通过设置匹配站点的HOST、URL Path或文件后缀等方式触发函数执行,可通过如下2个步骤操作:
1. 创建并部署函数成功后,按照提示单击新增触发规则
2. 在新增触发规则页面,配置匹配条件,以当前场景为例,可选择匹配类型为“HOST”、运算符为“等于”、值为已添加的子域名 www.example.com,单击确定即可创建触发规则。


步骤3:验证边缘函数

验证函数是否按照预期运行,您可通过在浏览器或 Curl 发起请求测验:
浏览器验证
Curl 验证
在浏览器输入 URL,例如:https://www.example.com/test-edgefunctions,该 URL 可匹配已设置的触发条件触发函数的执行,查看响应页面信息:

在 MAC/Linux 终端内,运行 curl 请求命令进行验证,例如:curl https://www.example.com/test-edgefunctions,可查看响应如下: