前言
函数计算支持以无服务器架构快速构建企业和开发者的软件系统,以其全托管事件触发模式、超弹性伸缩以及低廉的计费方式,相对于传统服务器架构,在开发效能和运维模式上都取得了明显优势。另外还提供了各种服务间的触发功能,作为云端各种产品的黏合剂,适用于各种应用场景。
本节,将带领大家利用函数计算,快速搭建一个功能完整的网盘服务。网盘服务的项目见(即将开源):
网盘服务简介
功能
网盘服务功能详细介绍请参考文章网盘服务系统和相应的项目 repo 。
本文重点不是介绍网盘功能,所以,请大家通过已经搭建好的网盘 demo 自行体验,这里不做过多赘述。
网盘系统无服务器架构
网盘服务功能集较多,这里就以上传文件功能为例,展现其网盘的实现架构。
网盘服务自身模块以及资源依赖
网盘服务的模块实现分为三个部分,如下图所示:
- apis : 提供了网盘的 API 接口功能,这部分功能是 serverless 架构实现的核心,使用 FC+API Gateway 架构模式实现主体功能,如上图无服务器架构图中展现的。
- Site : 提供了网盘实例的管理控制台,还有对应的网盘宣传、使用文档以及 api 文档等。
- UI : 提供用户使用和维护网盘的客户端。
这里,Site 和 UI 这两个子模块的实现都是静态网站模式,可以直接使用 OSS bucket 的 website 特性实现。为了简化整个部署流程和自动化资源编排过程,将 Site 和 UI 的部署方式也整合到 FC 中统一维护,见下面的详细的部署流程描述。
网盘服务功能后台依赖资源罗列如下:
fun 介绍
fun 是 have Fun with Serverless
的缩写,是一款 Serverless 应用开发的工具,可以帮助用户定义函数计算、API 网关、日志服务等资源,旨在与阿里云 ROS 兼容(尽管到目前为止 ROS 还不支持函数计算。但是,fun 作为 ROS 的子集是我们的目标)。
使用 fun 能够解决复杂服务的资源依赖维护问题,能够快速部署、更新,简化资源编排运维。针对该网盘服务的众多资源依赖,使用 fun 能够很方便、迅速的解决各种资源的搭建和维护过程。下面我们将演示如何使用 fun 部署网盘服务系统。
具体部署过程
网盘服务目前实现了三种身份登录验证功能: 钉钉、支付宝和特殊账号密码(用于测试)。
因为钉钉、支付宝登录方式需要走一些申请流程获取对应的 appID 和 appSecret ,这里为了简化流程,我们仅仅使用特殊账号密码方式。
部署的具体步骤如下:
准备工作:
- 云账号准备
- 代码准备
- fun 下载和配置
- 配置 fun 的 template.yml
- 部署 template.yml 定义资源,获取二级域名等信息
- 更新 apis function
- 部署 Site ,创建 groupID 实例
- 部署 UI,配置 storage 实例
准备工作
云账号准备
首先,准备一个能够登录阿里云官网的云账号, 登录控制台获取这个账号的 UID ( accountID )、 accessKeyID 和 accessKeySecret 。部署演示使用的资源全部在华东 2 ( cn-shanghai )。也可以使用其他 region 资源,但是必须保证所有的服务都在同一个 region 中。
然后开通如下服务:
代码准备
函数计算支持多种代码上传方式,这里统一打包成 zip 文件,并上传到该云账号的某个 bucket 上(用户自行在华东 2 创建即可)。参考代码如下连接:
-
- 注意: apis 使用 nodejs 实现,在打包之前需要执行
tnpm i
命令安装项目依赖。 解压后目录结构如下:
|-- controllers # 控制层,主要逻辑 |-- routes # api路由 |-- services # 公共方法,包含调用各个云产品的方法 |-- utils |-- models |-- node_modules # 项目依赖 |-- index.js # 服务入口 |-- conf.js # config 配置 |-- package.json
- 注意: apis 使用 nodejs 实现,在打包之前需要执行
-
- 解压后文件结构如下:
|-- deploy.py # 部署函数 |-- site # site代码目录 |-- 404.html |-- index.html |-- docs |-- static
-
- 解压后文件结构如下:
|-- deploy.py # 部署函数 |-- ui # ui代码目录 |-- 404.html |-- index.html |-- static
fun 下载和配置
如果您的系统已经安装有 node 8 及以上的环境配置,那么可以直接执行如下命令进行 fun 的安装
npm install @alicloud/fun -g
如果您不想安装 node 运行环境,那么可以直接下载 fun 的 binary 执行,参考各种环境 fun 的 release binary 。
然后设置 accountID、accessKeyID 和 accessKeySecret 以及 region,请使用准备步骤中的已经申请的云账号的参数进行配置,本示例中 region 选择 cn-shanghai :
# 如果是 binary ,执行 ./${binary_name} config
fun config
template.yml 配置
template.yml 模板配置是本部署中最重要的部分,因为网盘服务依赖的资源项比较多(主要是 API网关资源和表格存储资源), 建议下载参考模板直接修改,需要修改的内容已经使用 "TODO" 标识。
template.yml 的语法规范参考 fun 规范文档。
这面具体介绍配置中的相关部分:
ROSTemplateFormatVersion: '2015-09-01'
Transform: 'Aliyun::Serverless-2018-04-03'
Resources:
apsaradrivefc:
Type: 'Aliyun::Serverless::Service'
Properties:
Description: apsara drive
Policies:
- AliyunOTSFullAccess
- AliyunSTSAssumeRoleAccess
- AliyunOTSFullAccess
- AliyunLogFullAccess
- AliyunFCInvocationAccess
LogConfig:
Project: log-yunpan # TODO replace sls project name
Logstore: fclog
apis:
Type: 'Aliyun::Serverless::Function'
Properties:
Description: apis
Runtime: nodejs8
Timeout: 30
MemorySize: 128
Handler: index.handler
CodeUri: oss://apsaradrive-ui/download/apis.zip # TODO replaced the code location
EnvironmentVariables: # TODO replace all the values which has 'TODO' tag
ENV_CONFIG: '...'
DeploySite: # function name which deploys site
Type: 'Aliyun::Serverless::Function'
Properties:
Handler: 'deploy.my_handler'
Runtime: 'python2.7'
Description: 'function to deploy site'
MemorySize: 128
Timeout: 30
CodeUri: 'oss://apsaradrive-ui/download/site.zip' # TODO replaced by the code location
DeployUI: # function name witch deploys ui
Type: 'Aliyun::Serverless::Function'
Properties:
Handler: 'deploy.my_handler'
Runtime: 'python2.7'
Description: 'function to deploy ui'
MemorySize: 128
Timeout: 30
CodeUri: 'oss://apsaradrive-ui/download/ui.zip' # TODO replaced by the code location
apsaradriveapis:
Type: 'Aliyun::Serverless::Api'
...
ts-yunpan: # TODO replace ots instance name
Type: 'Aliyun::Serverless::TableStore'
Properties:
ClusterType: HYBRID
Description: for apsaradrive
...
log-yunpan: # TODO replace sls project name
Type: 'Aliyun::Serverless::Log'
Properties:
Description: log
fclog:
Type: 'Aliyun::Serverless::Log::Logstore'
Properties:
TTL: 10
ShardCount: 1
上面定义的 yaml 文件主要做了以下几件事情:
- 创建一个名为 'apsaradrivefc' 的 Service , 并且为这个 Service 创建一个具有
AliyunOTSFullAccess
、AliyunSTSAssumeRoleAccess
、AliyunOTSFullAccess
、AliyunLogFullAccess
和AliyunFCInvocationAccess
这几大权限的 Service Role。然后在这个 Service 下面创建三个 Function ,分别名为 'apis', 'DeploySite' 和 'DeployUI' 。 - 创建一个 LOG Project名为 'log-yunpan' , 然后在这个LOG Project 下面创建一个名为 'fclog' 的 Logstore ,作为 apsaradrivefc 这个 Service 下 Function 执行的日志收集 store 。
- 创建一个名为 'ts-yunpan' 的 OTS Instance , 并且在这面生成各种 Table 。
- 创建一个 API 网关分组: apsaradriveapis ,以及其下的各种 API 定义。
需要修改的内容:
- OTS Instance name: 全局有三处地方需要修改,请统一,因为 OTS Instance 在 region 范围全局唯一,尽量保持命名唯一性,注意: OTS Instance 命名规范。
- LOG Project name: 全局有两处地方需要修改,请统一,因为 LOG Project在region范围全局唯一,尽量保持命名唯一性,注意: LOG Project 命名规范。
- 三处 CodeUri ,分别是 apis ,Site 和 UI 三个模块的代码位置,目前 template.yml 中的默认配置可用,可以不修改。
- apis 这个 Function 中的 EnvironmentVariables 属性内部需要配置 API 网关分组的二级域名,因为当前步骤还没有生成这个参数,这里先不修改。
部署 template.yml 定义资源
直接执行如下命令:
# 在 template.yml 所在目录执行
# 如果是 binary ,执行 ./${binary_name} config
fun deploy
这个时候,你可以在 OTS、SLS、RAM、API 网关和 FC 的控制台上分别看到 fun 为网盘服务创建的各种资源,如下图:
更新 apis function
从上一步 fun 的部署输出日志中可以找到对应的 API 网关分组的二级域名,如下:
修改 apis 这个 Function 中的 EnvironmentVariables 属性内部需要配置 API 网关分组的二级域名,如下图位置:
仍然执行如下命令,进行function的环境变量更新
fun deploy
至此,apis 模块部署完毕。
部署 Site ,创建 groupID 实例
Site 模块的实现其实就是一个静态网站,我们可以利用 OSS 的静态网站功能实现,步骤如下:
- 修改 static/global.js 中的 endpoint ( apis 的二级域名)和 ui_endpoint (如果在华东2, 那么就是 ${uid}-ui.oss-cn-shanghai.aliyuncs.com )
- 创建 ${uid}-site 这个 bucket ,并设置为 public-read ACL
- 设置这个 bucket 的 website 的默认首页和 404 页面
- 上传整个代码目录
将所有的步骤按照函数计算编程模型封装如下,并创建为 Function: DeploySite 。封装的 Function 实现如下所示:
import oss2
import logging
import json
import shutil
import os
import sys
reload(sys)
sys.setdefaultencoding('utf8')
from oss2.models import BucketWebsite
def delete_file(filePath):
if os.path.exists(filePath):
for fileList in os.walk(filePath):
for name in fileList[2]:
os.remove(os.path.join(fileList[0],name))
shutil.rmtree(filePath)
def my_handler(event, context):
# event is json string, parse it
evt = json.loads(event)
logger = logging.getLogger()
endpoint = 'oss-cn-shanghai-internal.aliyuncs.com'
creds = context.credentials
auth = oss2.StsAuth(creds.accessKeyId, creds.accessKeySecret, creds.securityToken)
# create bucket for site named ${uid}-site, and set the ACL to public read
bucket_name = '%s-site' % (evt['uid'])
bucket = oss2.Bucket(auth, endpoint, bucket_name)
try:
bucket.create_bucket(permission=oss2.BUCKET_ACL_PUBLIC_READ)
except oss2.exceptions.BucketAlreadyExists:
logger.info("Bucket %s is already exist" % bucket_name)
# set static website
bucket.put_bucket_website(BucketWebsite('index.html', '404.html'))
# modify the config for site
code_dir = '/tmp/site/'
delete_file(code_dir)
shutil.copytree('/code/site/', code_dir)
data = u''
with open(os.path.join(code_dir, 'static/global.js')) as f:
for line in f.readlines():
if line.startswith('var endpoint = '):
line = u'var endpoint = \'%s\';\n' % (evt['endpoint'])
elif line.startswith('var ui_endpoint = '):
line = u'var ui_endpoint = \'http://%s.oss-cn-shanghai.aliyuncs.com\';\n' % (bucket_name)
data += line
with open(os.path.join(code_dir, '/tmp/site/static/global.js'), "w") as f:
f.writelines(data)
# put all the static code to the bucket
for root,dirs,files in os.walk(code_dir):
for filespath in files:
full_file_name = os.path.join(root,filespath)
bucket.put_object_from_file(full_file_name[len(code_dir):], full_file_name)
所以,只需要 Invoke 这个 Function 就能够完成 Site 模块的部署。接下来演示一下 Invoke 的过程。
登录函数计算控制台,找到对应的 Function: DeploySite ,修改触发事件,然后点击执行:
{
"uid": "replace with you accountID",
"endpoint": "replace with the SLD"
}
然后打开 Site 页面(如果 uid 为 apsaradrive 的话,那么 Site 的 URL 为: http://apsaradrive-site.oss-cn-shanghai.aliyuncs.com ),登录之后(使用默认的 username: admin, password: 1234 登录),创建 group 实例。
部署 UI,配置 storage 实例
部署 UI 的过程和 Site 类似,同样在控制台上找到 DeployUI,修改触发事件,注意事件格式定义如下:
{
"uid": "replace with you accountID",
"group_id": "replace with the group_id you just create in the Site web"
"endpoint": "replace with the SLD"
}
点击执行之后,就可以通过刚刚 Site 页面的 Group 入口进入 UI 页面:
在 UI 页面配置相关的 Storage :
接下来,您就可以对您的网盘进行各种文件操作了。