教你如何白嫖腾讯云云函数(serverless)快速免费搭建个人站点(一) | 入门

最近我利用腾讯云云函数(serverless)实现了公众号后台对接和简单爬虫应用,本着好东西要分享的互联网原则,决定写一篇入门文章,从用云函数搭建个人站点这个案例出发,主要面向苦后端久矣的前端开发人员,简单介绍云函数是什么、可以用来做什么以及如何动手使用它。

更酷的是,如果你和我一起跟着这个案例动手,搭建出来的站点是免费的、维护简单的、全网可访问的。

鉴于本人编码水平一般,serverless也是第一次玩,中间有什么讲得不对的地方还请各位大神海涵并指出;如果有些朋友是完全零基础但对文中提到的东西感兴趣的,也可以留言提问,我会尽可能答复。

那么,让我们开始吧。

A 云函数是什么呢?

根据腾讯云云函数产品文档(您也可以访问https://cloud.tencent.com/doc... 查看文档)的描述:腾讯云云函数(Serverless Cloud Function,SCF)是腾讯云为企业和开发者们提供的无服务器执行环境,帮助您在无需购买和管理服务器的情况下运行代码, 是实时文件处理和数据处理等场景下理想的计算平台。您只需使用 SCF 平台支持的语言编写核心代码并设置代码运行的条件,即可在腾讯云基础设施上弹性、安全地运行代码。

简单说就是如果你以前对服务器知识一无所知,那么现在也不需要知道了,你可以用你趁手的语言写个函数(比如用js,懂点node就行),函数即是服务(接口),写好直接就可以在任何地方触发调用了,其它的诸如服务器配置什么的都不需要操心。

B 云函数能干什么?

理论上传统后端能干的事儿云函数都能干,但术业有专攻,根据云函数的特性和当下的主流环境,建议用云函数来搭建小型web应用后端、公众号/小程序、工具型接口等。

事实上小程序推的云开发就是基于腾讯云的serverless的,包括了云函数、云数据库和云存储。

C 开始使用云函数

要使用腾讯云的云函数首先当然得登录腾讯云。

这里我们选择用腾讯云控制台的方式创建、编写和调试云函数,一来面向初学者图形界面更直观,二来个人项目没那么复杂,控制台足以覆盖常见场景。感兴趣的各位可以自行尝试命令行的方式。

登录后从控制台进入云函数功能页,点击左侧“函数服务”菜单进入函数管理页,点击“新建”新建云函数。

image

进到新建函数页,看运行环境一栏,作为一个只会JS的前端,我毫不犹豫选了Nodejs;云函数提供了4个版本的Nodejs供选择,6.10和8.9版本对async的支持有瑕疵,12.16版本相对太新,稳妥起见我选了10.15版本。

下面有很多有意思的模板可以选择,今天我们先选个Hello World。

image

然后就能看到生成的代码是这样的:

'use strict';
exports.main_handler = async (event, context, callback) => {
 console.log("Hello World")
 console.log(event)
 console.log(event["non-exist"])
 console.log(context)
 return event
};

可以在这编辑代码,但咱不着急,先点击“完成”完成函数的创建。然后我们可以看到腾讯云提供了在线编辑、在线调试、查看日志等非常实用且必要的功能。现在我们进入“函数管理-函数代码”重新审视自动生成的hello world代码。

这个函数有三个入参:event、context 和 callback,其中 callback 为可选参数。根据官方的文档:

event:使用此参数传递触发事件数据。

context:使用此参数向您的处理程序传递运行时信息。

callback(可选):使用此参数用于将您所希望的信息返回给调用方。在 Node.js 8.9 和 6.10 版本中,均可以使用 callback 来返回。在 Node.js 10.15 及 12.16 中,使用 async 描述的入口函数,需要使用 return 关键字返回,非 async 模式的入口函数,需要使用 callback 入参返回。

了解了这三个入参后就可以开始编写代码了,基本上你在node上能干的事这里都能干。不过需要注意的是,云函数是无状态的,不要使用全局变量或者文件写入的方式存储状态,如真有需要,建议接入腾讯云的另一款产品——对象存储。(语调渐渐有种恰了腾讯云的饭的既视感..)

既然node上能干的事基本都能干,那对npm包的使用支持自然不在话下。目前云函数运行时已经预先装好crypto-browserify、imagemagick、puppeteer、request等包,require进来就可以使用。

当然我们总会需要用到一些没有预装的包,控制台也提供了在线安装依赖的方法。首先在根目录下新建package.json文件,然后输入如下配置:

{ 
 "dependencies": {
 "koa": "^2.3.0", 
 "serverless-http": "^2.0.0", 
 "koa-proxy": "^0.9.0", 
 "koa-static-server": "^1.5.2" 
 }
}

在“保存”按钮旁选择上传方式为“在线安装依赖”,然后点击保存,完毕后就能看到根目录多了个node_modules文件夹。

image

刚刚我们install的包里,koa是个web框架,搭服务用的,它相当于一个插座,需要什么功能就插什么中间件去实现;koa-static-server就是一个中间件,顾名思义是负责静态资源服务的;koa-proxy后面我们会用它来做接口反代。

serverless-http这个包得特别提一下。正常情况下我们用koa起服务,需要listen一个端口,但云函数是不暴露端口的,serverless-http这个包提供了在云函数环境使用koa的能力。然后我们敲入以下代码:

'use strict';
const serverless = require("serverless-http");
const Koa = require('koa');
const app = new Koa();
const proxy = require('koa-proxy');
const server = require('koa-static-server');
​
exports.main_handler = async (event, context, callback) => { 
 console.log('event:' + JSON.stringify(event, null, 4)) 
 app.use( 
 server({
 rootDir: 'dist',
 rootPath: '/test_webserver' 
 }) 
 )
 const handler = serverless(app);
 return await handler(event, context);
};

很简单,先引入依赖包,然后在函数里打印event信息(这个不是必须的,但方便调试和查看日志),然后配置静态资源服务,最后用serverless-http处理返回。这样要注意rootDir是你的静态资源文件夹的名字,rootPath就填云函数的名称,比如我的云函数叫“test_webserver”,这里rootPath就填“/test_webserver”。

现在服务就算写好了,我们可以用下面的测试工具测试一下,测试事件选“Api gateway”,请求方式“get”,path暂时填“/test_webserver/index.html”,点击“测试”,测试结果显示“测试成功”,返回结果是“{"statusCode":404,"headers":{"content-type":"text/plain; charset=utf-8","content-length":"9"},"isBase64Encoded":false,"body":"Not Found"}”,这是正常的,因为我们并没有写前端页面嘛。

D 前端工程

前端大家按照自己的喜好用自己趁手的框架写就好,比如用vue给女朋友写个电子贺卡什么的←_←。我懒得在本地起项目,就用cdn引入的方式用react简单写了个欢迎页,再点“测试”,现在可以看到返回的html字符串了。

image

image

E 触发器

当然我们的最终目的是要能公网访问这个网站,那么如何实现呢?这就要祭出“触发器”了。根据官方文档:云函数不是始终运行的状态,而是在事件发生时由事件触发运行,并且在一次运行的过程中处理这一次事件。so,我们来试试给刚刚完成的云函数配置触发器。

点击“触发管理-创建触发器”,可以看到腾讯云提供和好几种触发方式,这里我们选“API网关触发”,注意要勾上“启用集成响应”。关于集成响应,更多的解释可以查阅官方的文档。

image

创建好后可以就可以看到这个api的访问路径了:

image

还记得前面配的rootPath吧?观察下api触发器自动生成的路径,最后一段就是我们的云函数名。

现在我们可以访问到刚刚建好的网站了,只需在访问路径后加上你的html文件名:(您也可以点击文末的“阅读原文”查看案例)

https://service-0h6foneu-1254...

image

其实除了配置触发器之外,云函数还有另外一种调用方式—— Invoke API,这种方式适合用在函数内部调用的场景,比如有一个生成短链接的云函数,由负责具体业务的接口云函数调用执行它并把生成的短链接返回给前端,这时用invoke触发就比用api触发器效率更高更优雅。具体就不在这展开讲了,如果大家感兴趣,下次可以单独开一篇文章来说。

F 接口和接口反代

到现在为止,我们已经实现了一个静态站点,你可以尽情的在里面加页面、加特效,duang~然后链接丢给你们家小/老可爱访问,给她/他一个surprise了。

但是也有的朋友并不满足于做一个静态站,想通过增加接口给网站接入一些诸如搜索、图片格式转换、长连接变短链接等服务,下一篇(如果有人想看的话-_-)我们将跟大家一起用云函数一步步实现一个自己的接口并且给今天建好的这个站点配置接口代理,让它能够访问到我们的接口,提供一些有意思的服务。

评论

暂无评论