Serverless 工程实践 | 自建 Apache OpenWhisk 平台

OpenWhisk 简介

OpenWhisk 是基于云的分布式事件驱动的编程服务。OpenWhisk 提供一种编程模型，将事件处理程序注册到云服务中，以处理各种不同的服务。其可以支持数千触发器和调用，可以对不同规模的事件进行响应。
​
OpenWhisk 是由许多组件构建的，这些组件让 OpenWhisk 成为一款优秀的开源 FaaS 平台。

Apache OpenWhisk 组件结构

OpenWhisk 部署

​实验机器操作系统为 Ubuntu 18.04 Desktop。使用 GitHub 上所提供的 incubator-openwhisk 进行安装，如果本机没有安装 Git，需要先安装 Git：

apt install git

接下来克隆 repo 到本地目录：

git clone https://github.com/apache/inc... openwhisk

克隆完成之后，显示如图所示。

Apache OpenWhisk 项目 Clone
​
进入 OpenWhisk 目录，并且执行脚本。OpenWhisk 是由 Scala 开发的，运行需要安装 Java 环境。下面的脚本实现了 Java 环境的安装，以及其他的所需要的软件：

cd openwhisk && cd tools/ubuntu-setup && ./all.sh

Apache OpenWhisk 安装配置如图所示。

Apache OpenWhisk 安装配置

OpenWhisk 使用 ansible 进行部署，环境变量定义在 ansible/environments/group_vars/all 下：

limits:
invocationsPerMinute: "{{ limit_invocations_per_minute | default(60) }}"
concurrentInvocations: "{{ limit_invocations_concurrent | default(30) }}"
concurrentInvocationsSystem: "{{ limit_invocations_concurrent_system | default
(5000) }}"
firesPerMinute: "{{ limit_fires_per_minute | default(60) }}"
sequenceMaxLength: "{{ limit_sequence_max_length | default(50) }}"

上面程序定义了 OpenWhisk 在系统中的限制。

• invocationsPerMinute 表示同一个 Namespace 每分钟调用 Action 的数量。
• concurrentInvocations 表示同一个 Namespace 的并发调用数量。
• concurrentInvocationsSystem 表示系统中所有 Namespace 的并发调用数量。
• firesPerMinute 表示同一个 Namespace 中每分钟调用 Trigger 的数量。
• sequenceMaxLength 表示 Action 的最大序列长度。

如果需要修改上述的默认值，可以把修改后的值添加到文件 ansible/environments/local/group_vars/all 的末尾。例如，Action 的最大序列长度为 100，可以将 sequenceMaxLength: 120 添加到文件的末尾。
​
接下来，为 OpenWhisk 配置一个持久存储的数据库，有 CouchDB 和 Cloudant 可选。以 CouchDB 为例，配置环境：

export OW_DB=CouchDBexport OW_DB_USERNAME=rootexport OW_DB_PASSWORD=PASSWORDexport OW_DB_PROTOCOL=httpexport OW_DB_HOST=172.17.0.1export OW_DB_PORT=5984

在 openwhisk/ansible 目录下，运行脚本，如图所示。
​

ansible-playbook -i environments/local/ setup.yml

执行脚本过程
​
接下来使用 CouchDB 部署 OpenWhisk，确保本地已经有了 db_local.ini。在 openwhisk/ 目录下执行部署命令：

./gradlew distDocker​

如果部署过程中出现问题（如下图所示），可能是没有安装 npm 导致的，此时可以执行如下指令。

部署过程可能报错示例

apt install npm

稍等片刻，可以看到 Build 成功页面，如图所示。

Build 成功示例
​
接下来进入 openwhisk/ansible 目录：

ansible-playbook -i environments/local/ couchdb.ymlansible-playbook -i environments/local/ initdb.ymlansible-playbook -i environments/local/ wipe.ymlansible-playbook -i environments/local/ apigateway.ymlansible-playbook -i environments/local/ openwhisk.ymlansible-playbook -i environments/local/ postdeploy.yml​

执行脚本过程如图所示。

执行脚本过程
​
部署成功后，OpenWhisk 会在系统中启动几个 Docker 容器。我们可以通过 docker ps 来查看：

docker ps --format "{{.Image}} \t {{.Names }}"

安装成功后的容器列表如图所示。

安装成功后的容器列表

开发者工具

OpenWhisk 提供了一个统一的命令行接口 wsk。生成的 wsk 在 openwhisk/bin 下。其有两个属性需要配置。

• API host 用于部署 OpenWhisk 的主机名或 IP 地址的 API。
• Authorization key（用户名或密码）用来授权操作 OpenWhisk 的 API。

设置 API host，在单机配置中的 IP 应该为 172.17.0.1，如图所示。

[./bin/wsk property set --apihost '172.17.0.1']()

设置 API host

设置 key：
​

./bin/wsk property set --auth `cat ansible/files/auth.guest

权限设置如图所示。

设置权限

OpenWhisk 将 CLI 的配置信息存储在 ~/.wskprops 中。这个文件的位置也可以通过环境变量 WSK_CONFIG_FILE 来指定。
​
验证 CLI：

wsk action invoke /whisk.system/utils/echo –p message hello –result{ "message": "hello"}​

体验测试

创建简单的动作（action），代码如下：

test.pydef main(args): num = args.get("number", "30")    return {"fibonacci": F(int(num))}def F(n): if n == 0: return 0 elif n == 1: return 1 else: return F(n - 1) + F(n - 2)

创建动作：

/bin/wsk action create myfunction ./test.py --insecure

函数创建如图所示。

创建函数

触发动作：

./bin/wsk -i action invoke myfunction --result --blocking --param nember 20

​得到结果，如图所示。

执行函数

至此，我们完成了 OpenWhisk 项目的部署以及测试。