Skip to content

Commit

Permalink
Enhance upgrade docs for starters
Browse files Browse the repository at this point in the history
  • Loading branch information
AlbumenJ committed Aug 27, 2024
1 parent 1b46adb commit 012e80d
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 8 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -64,13 +64,12 @@ dubbo:
### dubbo-spring-boot-starter
以下是一些 dubbo-spring-boot-starter 版本对应的 SpringBoot、JDK 依赖:

| Dubbo Starter | 版本 | 推荐 Spring Boot 版本 | 兼容 Spring Boot 范围 | JDK 要求 |
| --- | --- | --- | --- | --- |
| dubbo-spring-boot-starter3 | 3.3.0 | 3.2.0 | [3.0.x ~ 3.2.x] | 17 |
| dubbo-spring-boot-starter | 3.3.0 | 2.7.18 | [2.x ~ 3.0.x) | 8 |
| dubbo-spring-boot-starter | 3.2.21 | 2.7.18 | [2.x ~ 3.0.x) | 8 |
| dubbo-spring-boot-starter | 3.1.11 | 2.7.18 | [2.x ~ 3.0.x) | 8 |
| dubbo-spring-boot-starter | 2.7.21 | 2.3.1.RELEASE | [2.x ~ 3.0.x) | 8 |
| 版本 | 兼容 Spring Boot 范围 |
|-------|---------------|
| 3.3.x | [1.x ~ 3.x) |
| 3.2.x | [1.x ~ 3.x) |
| 3.1.x | [1.x ~ 2.x) |
| 2.7.x | [1.x ~ 2.x) |

### 其他组件starter

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,26 @@ Dubbo 3.3.0 版本开始默认序列化方式从 `fastjson2` 切换为 `hessian2

---

## 4. Starters
## 4. Dubbo Spring Boot Starters 更新

在 Dubbo 3.3.x 中,Dubbo Spring Boot Starters 为了方便依赖管理,提供了更多的 Starter 依赖。

此外:**为了遵循 Spring 规范的命名规范,从 3.3.0 版本开始,可观测相关 Starter 的 artifactId 从 `dubbo-spring-boot-observability-starter` 更名为 `dubbo-observability-spring-boot-starter`**

### Q1: Dubbo 3.3.x 版本中的 Starter 有哪些?
以下是 Dubbo 官方社区提供的 starter 列表(3.3.0+ 版本),方便在 Spring Boot 应用中快速使用:
* `dubbo-spring-boot-starter`,管理 dubbo 核心依赖,用于识别 application.properties 或 application.yml 中 `dubbo.` 开头的配置项,扫描 @DubboService 等注解。
* `dubbo-spring-boot-starter3`,管理 dubbo 核心依赖,与 dubbo-spring-boot-starter 相同,支持 spring boot 3.2 版本。
* `dubbo-nacos-spring-boot-starter`,管理 nacos-client 等依赖,使用 Nacos 作为注册中心、配置中心时引入。
* `dubbo-zookeeper-spring-boot-starter`,管理 zookeeper、curator 等依赖,使用 Zookeeper 作为注册中心、配置中心时引入(Zookeeper server 3.4 及以下版本使用)。
* `dubbo-zookeeper-curator5-spring-boot-starter`,管理 zookeeper、curator5 等依赖,使用 Zookeeper 作为注册中心、配置中心时引入。
* `dubbo-sentinel-spring-boot-starter`,管理 sentinel 等依赖,使用 Sentinel 进行限流降级时引入。
* `dubbo-seata-spring-boot-starter`,管理 seata 等依赖,使用 Seata 作为分布式事务解决方案时引入。
* `dubbo-observability-spring-boot-starter`,加入该依赖将自动开启 Dubbo 内置的 metrics 采集,可用于后续的 Prometheus、Grafana 等监控系统。
* `dubbo-tracing-brave-spring-boot-starter`,管理 brave/zipkin、micrometer 等相关相关依赖,使用 Brave/Zipkin 作为 Tracer,将 Trace 信息 export 到 Zipkin。
* `dubbo-tracing-otel-otlp-spring-boot-starter`,管理 brave/zipkin、micrometer 等相关相关依赖,使用 OpenTelemetry 作为 Tracer,将 Trace 信息 export 到 OTlp Collector。
* `dubbo-tracing-otel-zipkin-spring-boot-starter`,管理 brave/zipkin、micrometer 等相关相关依赖,使用 OpenTelemetry 作为 Tracer,将 Trace 信息 export 到 Zipkin。


---

Expand Down

0 comments on commit 012e80d

Please sign in to comment.