You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@apisix.apache.org by GitBox <gi...@apache.org> on 2022/05/24 09:37:05 UTC
[GitHub] [apisix] penghuima opened a new pull request, #7117: docs: add openwhisk CN document
penghuima opened a new pull request, #7117:
URL: https://github.com/apache/apisix/pull/7117
Signed-off-by: penghuima <29...@qq.com>
### Description
docs: add openwhisk CN document
Fixes # (issue)
### Checklist
- [ ] I have explained the need for this PR and the problem it solves
- [ ] I have explained the changes or the new features added to this PR
- [ ] I have added tests corresponding to this change
- [ ] I have updated the documentation to reflect this change
- [ ] I have verified that this change is backward compatible (If not, please discuss on the [APISIX mailing list](https://github.com/apache/apisix/tree/master#community) first)
<!--
Note
1. Mark the PR as draft until it's ready to be reviewed.
2. Always add/update tests for any changes unless you have a good reason.
3. Always update the documentation to reflect the changes made in the PR.
4. Make a new commit to resolve conversations instead of `push -f`.
5. To resolve merge conflicts, merge master instead of rebasing.
6. Use "request review" to notify the reviewer after making changes.
7. Only a reviewer can mark a conversation as resolved.
-->
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix] lunarwhite commented on a diff in pull request #7117: docs: add openwhisk CN document
Posted by GitBox <gi...@apache.org>.
lunarwhite commented on code in PR #7117:
URL: https://github.com/apache/apisix/pull/7117#discussion_r882313674
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将开源的分布式无服务器平台 [Apache OpenWhisk](https://openwhisk.apache.org) 作为动态上游集成至 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`. |
Review Comment:
```suggestion
| action | string | 是 | | | OpenWhisk action，例如 `hello`。 |
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将开源的分布式无服务器平台 [Apache OpenWhisk](https://openwhisk.apache.org) 作为动态上游集成至 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。
Review Comment:
```suggestion
在 OpenWhisk 中 `timeout` 字段的值设置范围从 1 ms 到 60000 ms，建议用户将 `timeout` 字段的值至少设置为 1000ms。
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将开源的分布式无服务器平台 [Apache OpenWhisk](https://openwhisk.apache.org) 作为动态上游集成至 APISIX。
+
+启用 `openwhisk` 插件后，该插件会终止对已配置 URI 的请求，并代表客户端向 OpenWhisk 的 API Host 端点发起一个新的请求，然后 `openwhisk` 插件会将响应信息返回至客户端。
Review Comment:
Refer to the [English version](https://github.com/apache/apisix/blob/master/docs/en/latest/plugins/openwhisk.md): `This Plugin can be configured on a Route and requests will be send to the configured OpenWhish API endpoint as the upstream.`
👍Good translation.
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将开源的分布式无服务器平台 [Apache OpenWhisk](https://openwhisk.apache.org) 作为动态上游集成至 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 测试环境
+
+1. 在使用 `openwhisk` 插件之前，你需要通过以下命令运行 OpenWhisk 独立集群模式。请确保当前环境中已经安装 Docker 软件。
Review Comment:
"standalone mode"-> "独立集群模式" or "单节点模式"?
Or just "stand-alone 模式"? (as other CN docs show)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix] hf400159 commented on a diff in pull request #7117: docs: add openwhisk CN document
Posted by GitBox <gi...@apache.org>.
hf400159 commented on code in PR #7117:
URL: https://github.com/apache/apisix/pull/7117#discussion_r880400934
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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` 字段的值设置范围从 1ms 到 60000ms，历史使用经验建议大家将 `timeout` 字段的值至少设置为 1000ms。
+
+:::
+
+## 启用插件
+
+### 搭建 Apache OpenWhisk 测试环境
+
+1.你可以通过以下 docker 命令搭建 OpenWhisk 独立集群模式，但前提是你的 Linux 系统已经安装了 Docker 软件：
+
+```shell
+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
+```
+
+2.安装 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 工具：
+
+你可以在 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 仓库下载已发布的适用于 Linux 系统的可执行二进制文件 wsk。
+
+3.在 OpenWhisk 中注册函数：
+
+```shell
+wsk property set --apihost "http://localhost:3233" --auth "23bc46b1-71f6-4ed5-8c54-816aa4f8c502:123zO3xZCLrMN6v2BKK1dXYFpXlPkccOFqm12CdAsMgRU4VrNZ9lyGVCGuMDGIwP"
+wsk action update test <(echo 'function main(){return {"ready":true}}') --kind nodejs:14
+```
+
+### 创建路由
+
+通过以下命令创建一个路由，并在配置文件中添加 `openwhisk` 插件：
+
+```shell
+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": "23bc46b1-71f6-4ed5-8c54-816aa4f8c502:123zO3xZCLrMN6v2BKK1dXYFpXlPkccOFqm12CdAsMgRU4VrNZ9lyGVCGuMDGIwP",
Review Comment:
`${service_token}` 代表一个变量。
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix] penghuima commented on a diff in pull request #7117: docs: add openwhisk CN document
Posted by GitBox <gi...@apache.org>.
penghuima commented on code in PR #7117:
URL: https://github.com/apache/apisix/pull/7117#discussion_r880382294
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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` 字段的值设置范围从 1ms 到 60000ms，历史使用经验建议大家将 `timeout` 字段的值至少设置为 1000ms。
+
+:::
+
+## 启用插件
+
+### 搭建 Apache OpenWhisk 测试环境
+
+1.你可以通过以下 docker 命令搭建 OpenWhisk 独立集群模式，但前提是你的 Linux 系统已经安装了 Docker 软件：
+
+```shell
+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
+```
+
+2.安装 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 工具：
+
+你可以在 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 仓库下载已发布的适用于 Linux 系统的可执行二进制文件 wsk。
+
+3.在 OpenWhisk 中注册函数：
+
+```shell
+wsk property set --apihost "http://localhost:3233" --auth "23bc46b1-71f6-4ed5-8c54-816aa4f8c502:123zO3xZCLrMN6v2BKK1dXYFpXlPkccOFqm12CdAsMgRU4VrNZ9lyGVCGuMDGIwP"
+wsk action update test <(echo 'function main(){return {"ready":true}}') --kind nodejs:14
+```
+
+### 创建路由
+
+通过以下命令创建一个路由，并在配置文件中添加 `openwhisk` 插件：
+
+```shell
+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": "23bc46b1-71f6-4ed5-8c54-816aa4f8c502:123zO3xZCLrMN6v2BKK1dXYFpXlPkccOFqm12CdAsMgRU4VrNZ9lyGVCGuMDGIwP",
Review Comment:
When executing `echo ${service_token}` the output is empty，Where can I set this string.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix] penghuima commented on a diff in pull request #7117: docs: add openwhisk CN document
Posted by GitBox <gi...@apache.org>.
penghuima commented on code in PR #7117:
URL: https://github.com/apache/apisix/pull/7117#discussion_r880372437
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 APISIX。
+
+启用 `openwhisk` 插件后，该插件会终止对已配置 URI 的请求，并代表客户端向 OpenWhisk 的 API Host 端点发起一个新的请求，然后 `openwhisk` 插件会将响应信息返回至客户端。
Review Comment:
这种空格检查您们是用什么工具检查的，有什么好用的工具推荐吗，我在vscode上安装了 AutoCorrect 插件，但貌似该插件并不能帮我检查出来所有空格错误
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 APISIX。
+
+启用 `openwhisk` 插件后，该插件会终止对已配置 URI 的请求，并代表客户端向 OpenWhisk 的 API Host 端点发起一个新的请求，然后 `openwhisk` 插件会将响应信息返回至客户端。
Review Comment:
What tools do you use to check this kind of space? Are there any useful tools recommended? I installed the AutoCorrect plug-in on vscode, but it seems that the plug-in can't help me check all space errors
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix] juzhiyuan merged pull request #7117: docs: add openwhisk CN document
Posted by GitBox <gi...@apache.org>.
juzhiyuan merged PR #7117:
URL: https://github.com/apache/apisix/pull/7117
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix] penghuima commented on a diff in pull request #7117: docs: add openwhisk CN document
Posted by GitBox <gi...@apache.org>.
penghuima commented on code in PR #7117:
URL: https://github.com/apache/apisix/pull/7117#discussion_r880372437
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 APISIX。
+
+启用 `openwhisk` 插件后，该插件会终止对已配置 URI 的请求，并代表客户端向 OpenWhisk 的 API Host 端点发起一个新的请求，然后 `openwhisk` 插件会将响应信息返回至客户端。
Review Comment:
这种空格检查您们是用什么工具检查的，有什么好用的工具推荐吗，我在vscode上安装了 AutoCorrect 插件，但貌似该插件并不能帮我检查出来所有空格错误
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix] hf400159 commented on a diff in pull request #7117: docs: add openwhisk CN document
Posted by GitBox <gi...@apache.org>.
hf400159 commented on code in PR #7117:
URL: https://github.com/apache/apisix/pull/7117#discussion_r880289923
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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` 字段的值设置范围从 1ms 到 60000ms，历史使用经验建议大家将 `timeout` 字段的值至少设置为 1000ms。
+
+:::
+
+## 启用插件
+
+### 搭建 Apache OpenWhisk 测试环境
+
+1.你可以通过以下 docker 命令搭建 OpenWhisk 独立集群模式，但前提是你的 Linux 系统已经安装了 Docker 软件：
+
+```shell
+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
+```
+
+2.安装 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 工具：
Review Comment:
```suggestion
2. 安装 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 工具：
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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` 字段的值设置范围从 1ms 到 60000ms，历史使用经验建议大家将 `timeout` 字段的值至少设置为 1000ms。
+
+:::
+
+## 启用插件
+
+### 搭建 Apache OpenWhisk 测试环境
+
+1.你可以通过以下 docker 命令搭建 OpenWhisk 独立集群模式，但前提是你的 Linux 系统已经安装了 Docker 软件：
Review Comment:
```suggestion
1. 在使用 `openwhisk` 插件之前，你需要通过以下命令运行 OpenWhisk 独立集群模式。请确保当前环境中已经安装 Docker 软件。
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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` 字段的值设置范围从 1ms 到 60000ms，历史使用经验建议大家将 `timeout` 字段的值至少设置为 1000ms。
+
+:::
+
+## 启用插件
+
+### 搭建 Apache OpenWhisk 测试环境
+
+1.你可以通过以下 docker 命令搭建 OpenWhisk 独立集群模式，但前提是你的 Linux 系统已经安装了 Docker 软件：
+
+```shell
+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
+```
+
+2.安装 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 工具：
+
+你可以在 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 仓库下载已发布的适用于 Linux 系统的可执行二进制文件 wsk。
+
+3.在 OpenWhisk 中注册函数：
Review Comment:
```suggestion
3. 在 OpenWhisk 中注册函数：
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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` 字段的值设置范围从 1ms 到 60000ms，历史使用经验建议大家将 `timeout` 字段的值至少设置为 1000ms。
+
+:::
+
+## 启用插件
+
+### 搭建 Apache OpenWhisk 测试环境
+
+1.你可以通过以下 docker 命令搭建 OpenWhisk 独立集群模式，但前提是你的 Linux 系统已经安装了 Docker 软件：
+
+```shell
+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
+```
+
+2.安装 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 工具：
+
+你可以在 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 仓库下载已发布的适用于 Linux 系统的可执行二进制文件 wsk。
+
+3.在 OpenWhisk 中注册函数：
+
+```shell
+wsk property set --apihost "http://localhost:3233" --auth "23bc46b1-71f6-4ed5-8c54-816aa4f8c502:123zO3xZCLrMN6v2BKK1dXYFpXlPkccOFqm12CdAsMgRU4VrNZ9lyGVCGuMDGIwP"
Review Comment:
```suggestion
wsk property set --apihost "http://localhost:3233" --auth "${service_token}"
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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 | 连接保持空闲而没被断开的时间（以毫秒为单位）。 |
Review Comment:
```suggestion
| keepalive_timeout | integer | 否 | 60000ms | [1000,...]ms | 当连接空闲时，保持该连接处于活动状态的时间（以毫秒为单位）。 |
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 APISIX。
+
+启用 `openwhisk` 插件后，该插件会终止对已配置 URI 的请求，并代表客户端向 OpenWhisk 的 API Host 端点发起一个新的请求，然后 `openwhisk` 插件会将响应信息返回至客户端。
Review Comment:
```suggestion
启用 `openwhisk` 插件后，该插件会终止对已配置 URI 的请求，并代表客户端向 OpenWhisk 的 API Host 端点发起一个新的请求，然后 `openwhisk` 插件会将响应信息返回至客户端。
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 APISIX。
Review Comment:
```suggestion
`openwhisk` 插件用于将开源的分布式无服务器平台 [Apache OpenWhisk](https://openwhisk.apache.org) 作为动态上游集成至 APISIX。
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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 调用时的身份认证 |
Review Comment:
```suggestion
| service_token | string | 是 | | | OpenWhisk service token，其格式为 `xxx:xxx` ，用于 API 调用时的身份认证。 |
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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` 字段的值设置范围从 1ms 到 60000ms，历史使用经验建议大家将 `timeout` 字段的值至少设置为 1000ms。
+
+:::
+
+## 启用插件
+
+### 搭建 Apache OpenWhisk 测试环境
+
+1.你可以通过以下 docker 命令搭建 OpenWhisk 独立集群模式，但前提是你的 Linux 系统已经安装了 Docker 软件：
+
+```shell
+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
+```
+
+2.安装 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 工具：
+
+你可以在 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 仓库下载已发布的适用于 Linux 系统的可执行二进制文件 wsk。
+
+3.在 OpenWhisk 中注册函数：
+
+```shell
+wsk property set --apihost "http://localhost:3233" --auth "23bc46b1-71f6-4ed5-8c54-816aa4f8c502:123zO3xZCLrMN6v2BKK1dXYFpXlPkccOFqm12CdAsMgRU4VrNZ9lyGVCGuMDGIwP"
+wsk action update test <(echo 'function main(){return {"ready":true}}') --kind nodejs:14
+```
+
+### 创建路由
+
+通过以下命令创建一个路由，并在配置文件中添加 `openwhisk` 插件：
+
+```shell
+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": "23bc46b1-71f6-4ed5-8c54-816aa4f8c502:123zO3xZCLrMN6v2BKK1dXYFpXlPkccOFqm12CdAsMgRU4VrNZ9lyGVCGuMDGIwP",
Review Comment:
```suggestion
"service_token": "${service_token}",
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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` 字段的值设置范围从 1ms 到 60000ms，历史使用经验建议大家将 `timeout` 字段的值至少设置为 1000ms。
+
+:::
+
+## 启用插件
+
+### 搭建 Apache OpenWhisk 测试环境
+
+1.你可以通过以下 docker 命令搭建 OpenWhisk 独立集群模式，但前提是你的 Linux 系统已经安装了 Docker 软件：
+
+```shell
+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
+```
+
+2.安装 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 工具：
+
+你可以在 [openwhisk-cli](https://github.com/apache/openwhisk-cli) 仓库下载已发布的适用于 Linux 系统的可执行二进制文件 wsk。
+
+3.在 OpenWhisk 中注册函数：
+
+```shell
+wsk property set --apihost "http://localhost:3233" --auth "23bc46b1-71f6-4ed5-8c54-816aa4f8c502:123zO3xZCLrMN6v2BKK1dXYFpXlPkccOFqm12CdAsMgRU4VrNZ9lyGVCGuMDGIwP"
+wsk action update test <(echo 'function main(){return {"ready":true}}') --kind nodejs:14
+```
+
+### 创建路由
+
+通过以下命令创建一个路由，并在配置文件中添加 `openwhisk` 插件：
+
+```shell
+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": "23bc46b1-71f6-4ed5-8c54-816aa4f8c502:123zO3xZCLrMN6v2BKK1dXYFpXlPkccOFqm12CdAsMgRU4VrNZ9lyGVCGuMDGIwP",
+ "namespace": "guest",
+ "action": "test"
+ }
+ }
+}'
+```
+
+### 测试请求
+
+使用 `curl` 命令测试：
+
+```shell
+curl -i http://127.0.0.1:9080/hello
+```
+
+正常返回结果：
+
+```json
+{ "ready": true }
+```
+
+## 禁用插件
+
+当你需要禁用 `openwhisk` 插件时，可以通过以下命令删除相应的 JSON 配置，APISIX 将会自动重新加载相关配置，无需重启服务：
+
+```shell
+curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
+{
+ "methods": ["GET"],
+ "uri": "/index.html",
Review Comment:
```suggestion
"uri": "/hello",
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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 调用超时（以毫秒为单位）。 |
Review Comment:
```suggestion
| timeout | integer | 否 | 60000ms | [1,60000]ms | OpenWhisk action 和 HTTP 调用超时时间（以毫秒为单位）。 |
```
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 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` 字段的值设置范围从 1ms 到 60000ms，历史使用经验建议大家将 `timeout` 字段的值至少设置为 1000ms。
Review Comment:
```suggestion
在 OpenWhisk 中 `timeout` 字段的值设置范围从 1 ms 到 60000 ms，历史使用经验建议大家将 `timeout` 字段的值至少设置为 1000ms。
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix] hf400159 commented on a diff in pull request #7117: docs: add openwhisk CN document
Posted by GitBox <gi...@apache.org>.
hf400159 commented on code in PR #7117:
URL: https://github.com/apache/apisix/pull/7117#discussion_r880402097
##########
docs/zh/latest/plugins/openwhisk.md:
##########
@@ -0,0 +1,136 @@
+---
+title: openwhisk
+keywords:
+ - APISIX
+ - Plugin
+ - OpenWhisk
+ - openwhisk
+description: 本文介绍了关于 Apache APISIX `openwhisk` 插件的基本信息及使用方法。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`openwhisk` 插件用于将 [Apache OpenWhisk](https://openwhisk.apache.org) 这款开源的分布式无服务器平台作为动态上游集成至 APISIX。
+
+启用 `openwhisk` 插件后，该插件会终止对已配置 URI 的请求，并代表客户端向 OpenWhisk 的 API Host 端点发起一个新的请求，然后 `openwhisk` 插件会将响应信息返回至客户端。
Review Comment:
sorry, I currently don't have a tool to detect extra spaces.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org