API 网关结合云函数 SCF 的使用场景非常丰富,本文将介绍如何基于 API 网关+云函数 SCF 快速部署 Serverless 的外卖订单系统。
消息推送使用的典型场景

外卖订单系统架构图

Demo 实战
- 安装Serverless Framework
npm install -g serverless
- 初始化项目模板
sls init -t websocket-order
- 查看项目目录
下载到本地后,查看项目目录结构如下:

包含 DB、网关、函数等多个子模块。
- db 目录用于创建 PG Serverless 数据库实例
-
apigateway 用于创建对应的 API :
- /bill 下单 API,HTTP 类型
- /getshopinfo,获取店铺菜单 API
- /pgws,用于做消息推送的 websocket API
-
函数列表如下:
-
消息推送相关函数:
- 注册函数 ws_register.py, 配置 DB 的环境变量
- 传输函数 ws_trans.py ,配置 DB 的环境变量以及 apiid= 消息推送API
- 注销函数 ws_unregister.py ,配置 DB 的环境变量以及 apiid= 消息推送API
- 下单函数 bill.py , 配置 DB 的环境变量以及 apiid= 消息推送API
- 拉取店铺信息函数 getshopinfo.py,配置 DB 的环境变量
- 初始化 DB 函数 init_db.py ,配置 DB 的环境变量
- 修改配置信息。将 .env.example 文件为 .env 文件,在 API 密钥管理 中获取 SecretId 和 SecretKey。
# secret for credential
TENCENT_SECRET_ID=xxxxxx
TENCENT_SECRET_KEY=xxxxxx
# global config
REGION=ap-shanghai
- 项目部署
- 更新配置及部署
- 执行 initdb-dev 函数,进行数据库初始化。在控制台或者 vscode 插件中,点击测试 initdb-dev 函数,对数据库进行初始化的建表等操作
- 更新 apiid 配置,再次部署
查看输出信息,在 functionbill 目录和 functionws_trans 目录的 serverless.yml 中,分别配置 websocket API 的 apiid ,并重新部署两个函数,刷新环境变量配置。

sls deploy --target=./function_ws_trans
sls deploy --target=./function_bill
- 更改客户端与厨房订单系统的地址
App点单系统.html 更改 29 行 以及 88 行中 xxxx 为:生成的 API 网关服务域名
店家厨房系统.html 更改 17 行 xxxx 为 API 网关服务域名
效果演示:

附录:参考文档和配置
- 安装 Serverless Framework
- 安装 Serverless DB
- API 网关的 yaml 完整配置
- SCF 的 yaml 完整配置
往期回顾
传送门:
欢迎访问:Serverless 中文网,您可以在 最佳实践 里体验更多关于 Serverless 应用的开发!