Version: 2.15

openwhisk

描述#

openwhisk 插件用于将开源的分布式无服务器平台 Apache OpenWhisk 作为动态上游集成至 APISIX。

启用 openwhisk 插件后，该插件会终止对已配置 URI 的请求，并代表客户端向 OpenWhisk 的 API Host 端点发起一个新的请求，然后 openwhisk 插件会将响应信息返回至客户端。

属性#

名称	类型	必选项	默认值	有效值	描述
api_host	string	是			OpenWhisk API Host 地址，例如 `https://localhost:3233`。
ssl_verify	boolean	否	true		当设置为 `true` 时执行 SSL 验证。
service_token	string	是			OpenWhisk service token，其格式为 `xxx:xxx` ，用于 API 调用时的身份认证。
namespace	string	是			OpenWhisk namespace，例如 `guest`。
action	string	是			OpenWhisk action，例如 `hello`。
result	boolean	否	true		当设置为 `true` 时，获得 action 元数据（执行函数并获得响应结果）。
timeout	integer	否	60000ms	[1,60000]ms	OpenWhisk action 和 HTTP 调用超时时间（以毫秒为单位）。
keepalive	boolean	否	true		当设置为 `true` 时，保持连接的活动状态以便重复使用。
keepalive_timeout	integer	否	60000ms	[1000,...]ms	当连接空闲时，保持该连接处于活动状态的时间（以毫秒为单位）。
keepalive_pool	integer	否	5	[1,...]	连接断开之前，可接收的最大请求数。

note

timeout 字段规定了 OpenWhisk action 的最大执行时间，以及 APISIX 中 HTTP 客户端的请求超时时间。

因为 OpenWhisk action 调用可能会耗费很长时间来拉取容器镜像和启动容器，所以如果 timeout 字段值设置太小，可能会导致大量的失败请求。

在 OpenWhisk 中 timeout 字段的值设置范围从 1 ms 到 60000 ms，建议用户将 timeout 字段的值至少设置为 1000ms。

启用插件#

搭建 Apache OpenWhisk 测试环境#

在使用 openwhisk 插件之前，你需要通过以下命令运行 OpenWhisk stand-alone 模式。请确保当前环境中已经安装 Docker 软件。

docker run --rm -d \
  -h openwhisk --name openwhisk \
  -p 3233:3233 -p 3232:3232 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  openwhisk/standalone:nightly
docker exec openwhisk waitready

安装 openwhisk-cli 工具：

你可以在 openwhisk-cli 仓库下载已发布的适用于 Linux 系统的可执行二进制文件 wsk。

在 OpenWhisk 中注册函数：

wsk property set --apihost "http://localhost:3233" --auth "${service_token}"
wsk action update test <(echo 'function main(){return {"ready":true}}') --kind nodejs:14

创建路由#

通过以下命令创建一个路由，并在配置文件中添加 openwhisk 插件：

curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
    "uri": "/hello",
    "plugins": {
        "openwhisk": {
            "api_host": "http://localhost:3233",
            "service_token": "${service_token}",
            "namespace": "guest",
            "action": "test"
        }
    }
}'

测试请求#

使用 curl 命令测试：

curl -i http://127.0.0.1:9080/hello

正常返回结果：

{ "ready": true }

禁用插件#

当你需要禁用 openwhisk 插件时，可以通过以下命令删除相应的 JSON 配置，APISIX 将会自动重新加载相关配置，无需重启服务：

curl http://127.0.0.1:9080/apisix/admin/routes/1  -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
    "methods": ["GET"],
    "uri": "/hello",
    "upstream": {
        "type": "roundrobin",
        "nodes": {
            "127.0.0.1:1980": 1
        }
    }
}'