社区/学习指南/云开发 Serverless 极简入门手册

编写第一个云函数

在 Serverless 中,云函数是作为计算容器存在的,可以作为服务接口使用,也可以做为中转服务使用,也可以编写业务逻辑。我们经常谈的 FaaS(Functions as a Service)中最核心的是云函数。如果需要简单理解,那就是写了一段代码(一个函数),可以直接部署在服务器上,但是这个函数是具备伸缩性的。流量来了,可以直接将函数拉起,可以进行资源扩充;流量回落,可以降至 0。这里不讨论业界如何实现冷启动或者 0 - 1 的优化。

上一节,我们在控制台创建了自己的环境;这里我们就可以在控制台编写第一个函数了。

创建函数

第 1 步:登录云开发控制台
网址:https://console.cloud.tencent.com/tcb

第 2 步:创建云函数
如下图:

  • 选择基础服务中的侧边栏【云函数】
  • 选择之前创建的环境,一定要选择在腾讯云云开发控制台创建的,目前小程序云开发的环境管理没有放开。
  • 点击【新建云函数】按钮;

如果云函数不需要占用大内存, 可以选择 128 MB;在控制台默认选择的是 256 MB 。

然后,可以直接点击【下一步】即可,如下图:

编写函数

我们在控制台创建函数完成,下面即可编写代码了。目前控制台默认提供了 Cloud Studio 作为编辑器,基本满足基础的 Web IDE 需要。
点击「函数名」,进入函数配置和详情页。

我们精简默认生成的,修改代码成如下:

"use strict";
exports.main = async (event, context) => {
  //这里代码比较简单
  //后期会准备从数据库取数据,然后返回结果
  return {
    msg: "Hello Serverless! Good good study !",
    maybe: "从入门到放弃",
  };
};

这里点击【保存】。【保存】和【保存并安装依赖】是有区别的:

  • 【保存并安装依赖】需要根据该函数目录下的 package.json 来安装依赖库,比如 node_modules;目前我们这个例子不依赖任何库,也没有 package.json 文件,所以不需要安装依赖;
  • 【保存】则是直接保存代码;

如果实在分不清楚,就直接点击【保存并安装依赖】吧。

设置函数可以使用 HTTP 访问

访问函数的形式有好几种,比如函数间调用,客户端 SDK 调用等;当前这里只介绍「开启 HTTP」触发的形式。有的同学对触发不理解,其实可以理解为 “使用 HTTP 访问“。

点击【函数配置】,对函数进行设置。

点击【编辑】,开始设定 HTTP 访问路径,这里设置为 “/say-hello” 。只需要修改这一个地方点击保存。

访问并验证返回的结果

点击生成的链接,即可在浏览器看到返回的数据。

浏览器返回数据如下:

{
  "msg": "Hello Serverless! Good good study !",
  "maybe": "从入门到放弃"
}

当你发布完成,这个云函数就具备下面特性

  • 具备应对流量的伸缩性,这个是云开发底层做的,无需开发者关系;
  • 无需安装 Web 容器,例如 Tomcat、Apache、Node.js Server;
  • 无需设置和暴露端口;
  • 无需 Nginx 、API 网关;
  • 可以自定义函数域名

当然真实的服务不止这么简单,例如:

  • 需要设置跨域访问。控制台侧边栏【环境】、【安全设置】【WEB 安全域名】可以开启;
  • 需要查询数据库返回数据,请看下一节;

通过 HTTP URL 传递参数到云函数

通过前面小节,我们已经可以编写和发布云函数了。但是有个问题,既然是 HTTP 服务,前端传递的参数如何获取呢?

http://api.serverless80.com/say-hello?name=vczero

例如上面 url 中的 name 参数该如何获取呢?可以通过 queryStringParameters 获取。例如计算两个数之和,代码如下:

"use strict";
exports.main = async (event, context) => {
  //这里代码比较简单
  //这里通过 queryStringParameters 获取请求参数
  let a = parseInt(event.queryStringParameters.a || 0);
  let b = parseInt(event.queryStringParameters.b || 0);
  return {
    msg: "Hello Serverless! Good good study !",
    maybe: "从入门到放弃",
    sum: a + b,
  };
};

HTTP 请求参数如下:

//可以点击生成的路径直接方案,需要加上 a, b 两个参数
https://你的环境ID.service.tcloudbase.com/say-hello?a=1&b=23

返回结果如下:

{
  "msg": "Hello Serverless! Good good study !",
  "maybe": "从入门到放弃",
  "sum": 24
}

详细内容可以参考 云接入

开启跨域访问

云函数可以通过 HTTP 访问了,也可以获取请求参数了,那么。在前端应用中,使用 ajax 请求生成的 http url 肯定会存在跨域情况。那么,在哪设置该函数可以被「指定域名」访问,其他域名不能访问呢。那就是开启 「安全域名」

可以配置:

  • 域名,例如 serverless80.com;
  • IP,例如 127.0.0.1:8000;
  • localhost:8000

可以根据开发、正式环境进行修改;应用正式上线后,记得删除无关域名。

自定义云函数服务域名

一般情况,可以使用默认生成的域名进行服务调用。但是如果有自己的域名,也可以配置。因为默认的域名生成的比较长,也没有规律,配置自定义域名显得统一性高一些。

可以按照上图进行配置,如果没有 SSL 安全证书,可以选择腾讯云的免费证书。免费证书只能配置一个域名,不能配置通配符域名,也就是子域名都需要重新申请。

本文出自 王利华