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/03/20 08:00:17 UTC
[servicecomb-docs] branch master updated: change directory for
start, provider/consumer development and add transport client configuration
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 389094f change directory for start, provider/consumer development and add transport client configuration
389094f is described below
commit 389094fa1bd2ac49b7f6f69d0b8917d5a7b4a026
Author: liubao <bi...@qq.com>
AuthorDate: Fri Mar 20 15:13:33 2020 +0800
change directory for start, provider/consumer development and add transport client configuration
---
.../zh_CN/docs/build-consumer/catalog.md | 12 ++++
.../zh_CN/docs/build-provider/catalog.md | 18 ++++++
.../docs/config-reference/rest-transport-client.md | 23 ++++++++
.../zh_CN/docs/general-development/catalog.md | 25 ++++++++
java-chassis-reference/zh_CN/docs/start/catalog.md | 8 +++
java-chassis-reference/zh_CN/mkdocs.yml | 69 ++++------------------
6 files changed, 96 insertions(+), 59 deletions(-)
diff --git a/java-chassis-reference/zh_CN/docs/build-consumer/catalog.md b/java-chassis-reference/zh_CN/docs/build-consumer/catalog.md
new file mode 100644
index 0000000..0606821
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/build-consumer/catalog.md
@@ -0,0 +1,12 @@
+# 开发服务消费者
+
+* [消费者通用配置项](common-configuration.md)
+* [使用RestTemplate开发服务消费者](using-resttemplate.md)
+* [使用AsynRestTemplate开发服务消费者](using-AsyncRestTemplate.md)
+* [使用RPC方式开发服务消费者](develop-consumer-using-rpc.md)
+* [使用服务契约](with-contract.md)
+* 调用控制
+ * [熔断策略](circuit-breaker.md)
+ * [限流策略](flow-control.md)
+ * [故障注入](fault-injection.md)
+* [调用第三方REST服务](3rd-party-service-invoke.md)
\ No newline at end of file
diff --git a/java-chassis-reference/zh_CN/docs/build-provider/catalog.md b/java-chassis-reference/zh_CN/docs/build-provider/catalog.md
new file mode 100644
index 0000000..23c02bb
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/build-provider/catalog.md
@@ -0,0 +1,18 @@
+# 开发服务提供者
+
+* [服务定义](definition/service-definition.md)
+* [定义服务契约](define-contract.md)
+* [使用隐式契约](code-first.md)
+* [使用Swagger注解](swagger-annotation.md)
+* [用SpringMVC开发微服务](springmvc.md)
+* [用JAX-RS开发微服务](jaxrs.md)
+* [用透明RPC开发微服务](transparent-rpc.md)
+* [接口定义和数据类型](interface-constraints.md)
+* [服务监听地址和发布地址](listen-address-and-publish-address.md)
+* [线程池](thread-pool.md)
+* 服务配置
+ * [限流策略](configuration/ratelimite-strategy.md)
+ * [降级策略](configuration/downgrade-strategy.md)
+ * [参数效验](configuration/parameter-validator.md)
+ * [程序启动逻辑](bootup.md)
+* [Access Log配置](access-log-configuration.md)
\ No newline at end of file
diff --git a/java-chassis-reference/zh_CN/docs/config-reference/rest-transport-client.md b/java-chassis-reference/zh_CN/docs/config-reference/rest-transport-client.md
new file mode 100644
index 0000000..b2acc79
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/config-reference/rest-transport-client.md
@@ -0,0 +1,23 @@
+# REST Transport Client 配置项
+
+|配置项名称|版本|缺省值|功能描述|
+|---|---|---|---|
+|servicecomb.rest.client.verticle-count||备注1|备注2|
+|servicecomb.rest.client.thread-count|废弃||同verticle-count|
+|servicecomb.rest.client.maxWaitQueueSize||-1|HTTP HTTP2 等待队列大小|
+|servicecomb.rest.client.connection.compression||false|HTTP HTTP2是否启用压缩|
+|servicecomb.rest.client.http2.maxPoolSize||1|HTTP2 客户端连接池大小|
+|servicecomb.rest.client.http2.multiplexingLimit||1||
+|servicecomb.rest.client.http2.idleTimeoutInSeconds|2.0.1|0|HTTP2 连接闲置超时时间|
+|servicecomb.rest.client.http2.useAlpnEnabled||true||
+|servicecomb.rest.client.connection.maxPoolSize||5|HTTP 客户端连接池大小|
+|servicecomb.rest.client.connection.idleTimeoutInSeconds||30|HTTP 连接闲置超时时间|
+|servicecomb.rest.client.connection.keepAlive||true|HTTP 连接是否保活|
+|servicecomb.rest.client.maxHeaderSize||8192|HTTP 最大头部限制|
+
+**备注**:
+
+1. 如果没有配置，或者配置的值小于8，为CPU的核数。 如果CPU核数小于8， 取8。
+2. java-chassis 默认采用 vert.x 的 HTTP Client 功能，这个配置项对应的是 verticle instances 数量。 verticle instances 数量
+ 会影响并发资源分配。比如： 如果 verticle instances 为 2， maxPoolSize 为 5， 那么实际创建的连接数为 2*5=10。
+
diff --git a/java-chassis-reference/zh_CN/docs/general-development/catalog.md b/java-chassis-reference/zh_CN/docs/general-development/catalog.md
new file mode 100644
index 0000000..abcc465
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/general-development/catalog.md
@@ -0,0 +1,25 @@
+# 通用功能开发
+
+* [访问服务中心](visit-sc.md)
+* [应用性能监控](metrics.md)
+* [微服务调用链](microservice-invocation-chain.md)
+* [自定义调用链打点](customized-tracing.md)
+* [本地开发和测试](local-develop-test.md)
+* [Http Filter](http-filter.md)
+* [文件上传下载](upload-download.md)
+* [Reactive](reactive.md)
+* [DNS自定义配置](dnsconfig.md)
+* [代理设置](dai-li-she-zhi.md)
+* [框架上报版本号](report-framework-version.md)
+* [跨应用调用](cross-app-invocation.md)
+* [定制序列化和反序列化方法](secret-field.md)
+* [使用Context传递控制消息](context.md)
+* [返回值序列化扩展](produceprocess.md)
+* [CORS机制](CORS.md)
+* [获取熔断与实例隔离告警事件信息](AlarmEvent.md)
+* [优雅停机](shutdown.md)
+* [异常处理](error-handling.md)
+* [微服务实例间多环境隔离](multienvironment.md)
+* [线程模型](thread-model.md)
+
+
\ No newline at end of file
diff --git a/java-chassis-reference/zh_CN/docs/start/catalog.md b/java-chassis-reference/zh_CN/docs/start/catalog.md
new file mode 100644
index 0000000..8c215be
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/start/catalog.md
@@ -0,0 +1,8 @@
+# 快速入门
+
+* [术语表](terminology.md)
+* [微服务系统架构](architecture.md)
+* [安装本地开发环境](development-environment.md)
+* [开发第一个微服务](first-sample.md)
+* [完整例子-bmi应用](../featured-topics/application-bmi.md)
+* [完整例子-porter应用](../featured-topics/application-porter.md)
diff --git a/java-chassis-reference/zh_CN/mkdocs.yml b/java-chassis-reference/zh_CN/mkdocs.yml
index 13e169e..8190953 100644
--- a/java-chassis-reference/zh_CN/mkdocs.yml
+++ b/java-chassis-reference/zh_CN/mkdocs.yml
@@ -1,69 +1,18 @@
site_name: ServiceComb Java Chassis 开发指南
nav:
+
- 概述 : index.md
-- 入门:
- - 术语表: 'start/terminology.md'
- - 微服务系统架构: 'start/architecture.md'
- - 安装本地开发环境: 'start/development-environment.md'
- - 开发第一个微服务: start/first-sample.md
- - 完整例子-bmi应用: featured-topics/application-bmi.md
- - 完整例子-porter应用: featured-topics/application-porter.md
-- 开发服务提供者:
- - 服务定义: build-provider/definition/service-definition.md
- - 定义服务契约: build-provider/define-contract.md
- - 使用隐式契约: build-provider/code-first.md
- - 使用Swagger注解: build-provider/swagger-annotation.md
- - 用SpringMVC开发微服务: build-provider/springmvc.md
- - 用JAX-RS开发微服务: build-provider/jaxrs.md
- - 用透明RPC开发微服务: build-provider/transparent-rpc.md
- - 接口定义和数据类型: build-provider/interface-constraints.md
- - 服务监听地址和发布地址: build-provider/listen-address-and-publish-address.md
- - 线程池: build-provider/thread-pool.md
- - 服务配置:
- - 限流策略: build-provider/configuration/ratelimite-strategy.md
- - 降级策略: build-provider/configuration/downgrade-strategy.md
- - 参数效验: build-provider/configuration/parameter-validator.md
- - 程序启动逻辑: build-provider/bootup.md
- - Access Log配置: build-provider/access-log-configuration.md
-- 开发服务消费者:
- - 消费者通用配置项: build-consumer/common-configuration.md
- - 使用RestTemplate开发服务消费者: build-consumer/using-resttemplate.md
- - 使用AsynRestTemplate开发服务消费者: build-consumer/using-AsyncRestTemplate.md
- - 使用RPC方式开发服务消费者: build-consumer/develop-consumer-using-rpc.md
- - 使用服务契约: build-consumer/with-contract.md
- - 调用控制:
- - 熔断策略: build-consumer/circuit-breaker.md
- - 限流策略: build-consumer/flow-control.md
- - 故障注入: build-consumer/fault-injection.md
- - 调用第三方REST服务: build-consumer/3rd-party-service-invoke.md
-- Transports:
+- 快速入门: start/catalog.md
+- 开发服务提供者: build-provider/catalog.md
+- 开发服务消费者: build-consumer/catalog.md
+- 通用功能开发: general-development/catalog.md
+
+- Transports:
- REST over Servlet: transports/rest-over-servlet.md
- REST over Vertx: transports/rest-over-vertx.md
- Highway: transports/highway-rpc.md
- HTTP2: transports/http2.md
-- 通用开发:
- - 访问服务中心: general-development/visit-sc.md
- - 应用性能监控: general-development/metrics.md
- - 微服务调用链: general-development/microservice-invocation-chain.md
- - 自定义调用链打点: general-development/customized-tracing.md
- - 本地开发和测试: general-development/local-develop-test.md
- - Http Filter: general-development/http-filter.md
- - 文件上传下载: general-development/upload-download.md
- - Reactive: general-development/reactive.md
- - DNS自定义配置: general-development/dnsconfig.md
- - 代理设置: general-development/dai-li-she-zhi.md
- - 框架上报版本号: general-development/report-framework-version.md
- - 跨应用调用: general-development/cross-app-invocation.md
- - 定制序列化和反序列化方法: general-development/secret-field.md
- - 使用Context传递控制消息: general-development/context.md
- - 返回值序列化扩展: general-development/produceprocess.md
- - CORS机制: general-development/CORS.md
- - 获取熔断与实例隔离告警事件信息: general-development/AlarmEvent.md
- - 优雅停机: general-development/shutdown.md
- - 异常处理: general-development/error-handling.md
- - 微服务实例间多环境隔离: general-development/multienvironment.md
- - 线程模型: general-development/thread-model.md
- 管理服务配置:
- 通用配置说明: config/general-config.md
- 配置注入机制: config/inject-config.md
@@ -87,7 +36,9 @@ nav:
- 处理链介绍: references-handlers/intruduction.md
- 负载均衡: references-handlers/loadbalance.md
- 公钥认证: references-handlers/publickey.md
-- 常见问题:
+- 常用配置项参考:
+ - REST Transport Client 配置项: config-reference/rest-transport-client.md
+- 常见问题:
- 'Q & A' : question-and-answer/question_answer.md
- 'FAQ' : question-and-answer/faq.md
- 微服务接口兼容常见问题: question-and-answer/interface-compatibility.md