You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@servicecomb.apache.org by li...@apache.org on 2020/07/10 07:06:07 UTC
[servicecomb-docs] branch master updated: Add some configurations
notice
This is an automated email from the ASF dual-hosted git repository.
liubao pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/servicecomb-docs.git
The following commit(s) were added to refs/heads/master by this push:
new 0d9a9ec Add some configurations notice
0d9a9ec is described below
commit 0d9a9eca9603f771d209ea975459ab527bba0941
Author: liubao <bi...@qq.com>
AuthorDate: Tue Jul 7 16:51:44 2020 +0800
Add some configurations notice
---
.../zh_CN/docs/references-handlers/loadbalance.md | 9 +++++++++
.../zh_CN/docs/transports/rest-over-servlet.md | 3 +++
java-chassis-reference/zh_CN/docs/transports/rest-over-vertx.md | 1 +
3 files changed, 13 insertions(+)
diff --git a/java-chassis-reference/zh_CN/docs/references-handlers/loadbalance.md b/java-chassis-reference/zh_CN/docs/references-handlers/loadbalance.md
index e6636dd..c3b1875 100644
--- a/java-chassis-reference/zh_CN/docs/references-handlers/loadbalance.md
+++ b/java-chassis-reference/zh_CN/docs/references-handlers/loadbalance.md
@@ -66,7 +66,9 @@ servicecomb:
该规则默认启用，如果不需要使用，可以通过`servicecomb.loadbalance.filter.instanceProperty.enabled`进行关闭。根据实例属性进行路由转发功能在`InstancePropertyDiscoveryFilter`实现。
## 实例隔离功能
+
开发者可以配置实例隔离的参数，以暂时屏蔽对于错误实例的访问，提升系统可靠性和性能。下面是其配置项和缺省值
+
```yaml
servicecomb:
loadbalance:
@@ -93,6 +95,7 @@ servicecomb:
2. 配置SPI：增加META-INF/services/org.apache.servicecomb.serviceregistry.consumer.MicroserviceInstancePing，内容为实现类的全名
开发者可以针对不同的微服务配置不一样的隔离策略。只需要给配置项增加服务名，例如：
+
```yaml
servicecomb:
loadbalance:
@@ -107,6 +110,9 @@ servicecomb:
该规则默认启用，如果不需要使用，可以通过servicecomb.loadbalance.filter.isolation.enabled进行关闭。数据中心信息隔离功能在IsolationDiscoveryFilter实现。
+***注意：*** 多数异常都会触发隔离计数。但一般的 `InvocationException` 不会触发隔离计数。详细可以参考
+`LoadbalanceHandler` 的 `isFailedResponse` 方法实现。
+
## 配置路由规则
开发者可以通过配置项指定负载均衡策略。
```yaml
@@ -158,6 +164,9 @@ servicecomb:
retryOnNext表示失败以后，根据负载均衡策略，重新选择一个实例重试（可能选择到同一个实例）。 retryOnSame表示仍然使用上次失败的实例进行重试。
+***注意:*** 并不是所有的异常都会触发重试。缺省的情况，只有网络异常，或者 503 错误码才会触发重试。 详细可以
+参考 `DefaultRetryExtensionsFactory` 的定义。
+
## 自定义
负载均衡模块提供的功能已经非常强大，能够通过配置支持大部分应用场景。同时它也提供了强大的扩展能力，包括DiscoveryFilter、ServerListFilterExt、ExtensionsFactory（扩展IRule，RetryHandler等）。loadbalance模块本身包含了每一个扩展的实现，这里不再详细描述如何扩展，只简单描述步骤。开发者可以自行下载ServiceComb源码进行参考。
diff --git a/java-chassis-reference/zh_CN/docs/transports/rest-over-servlet.md b/java-chassis-reference/zh_CN/docs/transports/rest-over-servlet.md
index f83d9bc..c2e58db 100644
--- a/java-chassis-reference/zh_CN/docs/transports/rest-over-servlet.md
+++ b/java-chassis-reference/zh_CN/docs/transports/rest-over-servlet.md
@@ -212,5 +212,8 @@ REST over Servlet在microservice.yaml文件中的配置项见表3-9。
| servicecomb.rest.server.timeout | -1 | 否 |异步servlet超时时间, 单位为毫秒<br>建议保持默认值 |
| servicecomb.rest.server.requestWaitInPoolTimeout | 30000 | 否 |在同步线程中排队等待执行的超时时间，单位为毫秒 |
| servicecomb.rest.servlet.urlPattern | 无 | 否 | 用于简化servlet+servlet mapping配置<br>只有在web.xml中未配置servlet+servlet mapping时，才使用此配置项，配置格式为：/\* 或 /path/\*，其中path可以是多次目录 |
+| servicecomb.uploads.maxSize | 无 | 否 | 文件上传 form body 最大大小 |
+| servicecomb.uploads.maxFileSize | 无 | 否 | 文件上传所有文件总的大小限制 |
+| servicecomb.uploads.fileSizeThreshold | 无 | 否 | 文件上传，实际写入磁盘文件的最大大小 |
diff --git a/java-chassis-reference/zh_CN/docs/transports/rest-over-vertx.md b/java-chassis-reference/zh_CN/docs/transports/rest-over-vertx.md
index a714f6e..44bd3df 100644
--- a/java-chassis-reference/zh_CN/docs/transports/rest-over-vertx.md
+++ b/java-chassis-reference/zh_CN/docs/transports/rest-over-vertx.md
@@ -43,6 +43,7 @@ REST over Vertx通道在microservice.yaml文件中有以下配置项：
| servicecomb.rest.client.connection.keepAlive | true | 是否使用长连接 |
| servicecomb.rest.client.connection.compression | false | 客户端是否支持启用压缩 |
| servicecomb.rest.client.maxHeaderSize | 8192 | 客户端接收响应的最大header长度，单位字节 |
+| servicecomb.uploads.maxSize | 无限制 | 最大 body 大小，这个配置项对文件上传，REST请求都生效|
### 补充说明
* 极限连接数计算