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/06/17 06:16:26 UTC
[servicecomb-docs] branch master updated: [SCB-2002]add documents
on how to deploy without service center
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 8611fdb [SCB-2002]add documents on how to deploy without service center
8611fdb is described below
commit 8611fdb340955ae92405bf5e7add6afa4a60ca38
Author: liubao <bi...@qq.com>
AuthorDate: Wed Jun 17 11:56:28 2020 +0800
[SCB-2002]add documents on how to deploy without service center
---
.../zh_CN/docs/featured-topics/compatibility.md | 7 ++-
.../zh_CN/docs/registry/distributed.md | 64 ++++++++++++++++++++++
java-chassis-reference/zh_CN/docs/toc.md | 1 +
java-chassis-reference/zh_CN/mkdocs.yml | 1 +
4 files changed, 70 insertions(+), 3 deletions(-)
diff --git a/java-chassis-reference/zh_CN/docs/featured-topics/compatibility.md b/java-chassis-reference/zh_CN/docs/featured-topics/compatibility.md
index 5476658..4ad29df 100644
--- a/java-chassis-reference/zh_CN/docs/featured-topics/compatibility.md
+++ b/java-chassis-reference/zh_CN/docs/featured-topics/compatibility.md
@@ -7,7 +7,7 @@
减少对现有系统功能的影响;(2)保持兼容需要在代码中增加复杂性,这些复杂性可能并不是实现现实业务逻辑必须的,继而
给现有系统功能的可靠性带来间接影响;从开发者的角度,做不兼容性重构通常是不得已而为之,或者由于现有接口设计不
合理影响扩展,或者存在某些未考虑的缺陷,不期望使用者继续使用。如果保持兼容,使用者不能感知到这个变化,
-直到该功能在实际环境出现问题,增加了问题发现时间,。
+直到该功能在实际环境出现问题,增加了问题发现时间。
软件不可能一开始就被设计的完美,因此兼容性问题会一直存在。需要结合兼容性的场景和兼容性的影响,综合评估兼容策略,
使得既保持引入新版本的效率,又能够在每次升级新版本的时候,修复已知问题,让版本升级变得更有价值。
@@ -91,7 +91,8 @@ java-chassis 自身也使用了大量的三方件,为了更好的平衡升级
废弃用法,及时调整为正确的用法,使用新的版本,更容易从社区获得对于新发现问题的帮助。持续升级是一个系统
的工程实践,不单单指升级版本,还包括为了预防升级版本给质量带来风险而采取的其他措施,比如自动化测试的持续
构建,持续集成流水线的构建,定期阅读重要项目的 Release Notes,关注项目发展方向等等。 这种方式是一种主动
- 质量加固措施,可以免于问题发生。可惜多数决策者看到的是更新版本带来的问题,看不到被预防措施的积极效果,
- 没有把持续升级作为一项重要的能力建设事项纳入计划,这项能力一直得不到提升。
+ 质量加固措施,可以免于问题发生。可惜多数决策者看到的是更新版本带来的问题,看不到预防措施的积极效果,
+ 没有把持续升级作为一项重要的能力建设事项纳入计划,这项能力一直得不到提升,当实施升级的时候,更容易引入故障。
+
diff --git a/java-chassis-reference/zh_CN/docs/registry/distributed.md b/java-chassis-reference/zh_CN/docs/registry/distributed.md
new file mode 100644
index 0000000..a66095d
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/registry/distributed.md
@@ -0,0 +1,64 @@
+# 去中心化注册发现
+
+去中心化注册发现指不通过服务中心中间件,实现服务注册发现。去中心化注册发现比较适合于小规模管理面服务的开发,或者
+对于弹性扩缩容要求不高的场景。 servicecomb 提供了两种方式满足去中心化的注册发现。这两种方式涉及如下模块:
+
+* 本地注册发现: registry-local,通过本地配置文件注册发现
+* 广播注册发现: registry-zeroconfig, 采用广播的方式注册发现
+* 实例契约发现: registry-schema-dicovery, 通过给实例发送请求,从实例查询契约
+
+## 本地注册发现 + 实例契约发现
+
+通过组合本地注册发现和实例契约发现能够实现去中心化注册发现。这种场景需要 consumer 配置 provider 的地址信息,
+适合 provider 地址固定的场景。 或者在容器部署的场景(比如 Istio), consumer 可以通过固定的服务名访问 provider,
+采用这种注册发现方式能够很好利用容器的发现能力。
+
+通过组合本地注册发现和实例契约发现包含下面几个开发步骤:
+
+* 引入相关依赖
+
+ ```xml
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>registry-schema-discovery</artifactId>
+ </dependency>
+ ```
+
+ 备注: registry-schema-discovery 依赖于 registry-local
+
+* 在 consumer 的 `registry.yaml` 中配置 provider 的微服务和微服务实例信息
+
+```yaml
+demo-zeroconfig-schemadiscovery-registry-edge:
+ - id: "002"
+ version: "0.0.2"
+ appid: demo-zeroconfig-schemadiscovery-registry
+ schemaIds:
+ - ClientServerEndpoint
+ - SchemaDiscoveryEndpoint
+ instances:
+ - endpoints:
+ - rest://localhost:8888
+```
+
+## 广播注册发现 + 实例契约发现
+
+广播注册发现采用UDP协议发现实例。使用这种方式只需要在项目中配置依赖:
+
+```xml
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>registry-schema-discovery</artifactId>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>registry-zero-config</artifactId>
+ </dependency>
+```
+
+可以看出使用这种方式非常简单,也是 zero-config 名称的由来。
+
+## 注意事项
+
+使用去中心化注册发现,一般会去掉集中注册发现模块的依赖。 如果没去掉依赖,就会存在多种注册发现并存的情况。这种
+情况的行为可以参考注册发现概述的内容。
diff --git a/java-chassis-reference/zh_CN/docs/toc.md b/java-chassis-reference/zh_CN/docs/toc.md
index 62a0d36..335728f 100644
--- a/java-chassis-reference/zh_CN/docs/toc.md
+++ b/java-chassis-reference/zh_CN/docs/toc.md
@@ -70,6 +70,7 @@
* [HTTP2](transports/http2.md)
* 管理注册发现:
* [注册发现说明](registry/introduction.md)
+ * [去中心化注册发现](registry/distributed.md)
* [组合使用多个实现](registry/multi-registries.md)
* 管理服务配置:
* [通用配置说明](config/general-config.md)
diff --git a/java-chassis-reference/zh_CN/mkdocs.yml b/java-chassis-reference/zh_CN/mkdocs.yml
index f4aaa8b..acffdf4 100644
--- a/java-chassis-reference/zh_CN/mkdocs.yml
+++ b/java-chassis-reference/zh_CN/mkdocs.yml
@@ -17,6 +17,7 @@ nav:
- HTTP2: transports/http2.md
- 管理注册发现:
- 注册发现说明: registry/introduction.md
+ - 去中心化注册发现: registry/distributed.md
- 组合使用多个实现: registry/multi-registries.md
- 管理服务配置:
- 通用配置说明: config/general-config.md