Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 25 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,21 +19,29 @@ Spring Cloud Huawei provides a large number of out-of-the-box service governance

## Supported version

| Branch | Spring Cloud Huawei Latest Version | Compiled Spring Cloud Version | Compiled Spring Boot Version |
|-----------|------------------------------------|-------------------------------|------------------------------|
| master | 1.11.4-2021.0.x | 2021.0.8 | 2.7.17 |
| 2020.0.x | 1.10.8-2020.0.x | 2020.0.6 | 2.5.14 |
| Hoxton | 1.9.3-Hoxton | Hoxton.SR9 | 2.3.5.RELEASE |
| Greenwich | 1.6.3-Greenwich | Greenwich.SR6 | 2.1.6-RELEASE |
| Branch | Spring Cloud Huawei Latest Version | Compiled Spring Cloud Version | Compiled Spring Boot Version | Tested JDK Version | Notes |
|-----------|------------------------------------|-------------------------------|------------------------------|--------------------|----------------|
| master | 1.11.13-2024.0.x(推荐) | 2024.0.2 | 3.4.12 | OpenJDK 17 | |
| 2023.0.x | 1.11.13-2023.0.x(推荐) | 2023.0.6 | 3.3.13 | OpenJDK 17 | |
| 2022.0.x | 1.11.10-2022.0.x | 2022.0.5 | 3.1.12 | OpenJDK 17 | End of Support |
| 2021.0.x | 1.11.13-2021.0.x(推荐) | 2021.0.9 | 2.7.18 | OpenJDK 8 | Vulnerability |
| 2020.0.x | 1.10.8-2020.0.x | 2020.0.6 | 2.5.14 | OpenJDK 8 | End of Support |
| Hoxton | 1.9.4-Hoxton | Hoxton.SR9 | 2.3.5.RELEASE | OpenJDK 8 | End of Support |
| Greenwich | 1.6.4-Greenwich | Greenwich.SR6 | 2.1.6-RELEASE | OpenJDK 8 | End of Support |
| Finchley | 1.6.1-Finchley | 2.0.4.RELEASE | 2.0.9.RELEASE | OpenJDK 8 | End of Support |
| Edgware | 1.2.0-Edgware | 1.3.6.RELEASE | 1.5.22.RELEASE | OpenJDK 8 | End of Support |

***Notice:***
* Upgrade to the OOS version 2023.0.x/2024.0.X of the Spring community as soon as possible, because of 2021.0.x branch dependence Spring 5.3.x has certain vulnerabilities.
* You can use `Spring Cloud` compatible version to use `Spring Cloud Huawei`. See https://spring.io/projects/spring-cloud for more details.
* Spring Cloud Edgeware, Finchley, Greenwich, Hoxton have all reached end of life status and
* Spring Cloud Edgeware, Finchley, Greenwich, Hoxton, 2020.0.x have all reached end of life status and
suggest not for production use. Check [Spring Cloud Releases][Spring Cloud Releases] for details.
* Before Hoxton(include), Netfix OSS like Ribbon, Hystrix are supported. After 2020.0.x(include),
* Before Hoxton(include), Netfix OSS like Ribbon, Hystrix are supported. After 2020.0.x(**include**),
Spring Cloud Loadbalancer are supported.
* Before 2020.0.x(include), springfox is used for swagger generation. After 2021.0.x(include),
springdoc is used for swagger generation.
* After 2022.0.x(include), JDK 17+ is needed to run.
* Spring Cloud Huawei historical versions Spring Boot, Spring Cloud dependency description reference [version description][Spring Cloud Huawei Releases].

## How to use

Expand All @@ -42,9 +50,9 @@ Spring Cloud Huawei provides a large number of out-of-the-box service governance
3. [CSE Guide][CSE Developer Guide]
4. [ServiceStage Guide][ServiceStage]

[ServiceStage]: https://support.huaweicloud.com/intl/en-us/productdesc-servicestage/ss_productdesc_0001.html
[ServiceStage]: https://support.huaweicloud.com/intl/en-us/usermanual-servicestage/servicestage_03_0001.html
[CSE]: https://www.huaweicloud.com/intl/en-us/product/cse.html
[CSE Developer Guide]: https://support.huaweicloud.com/intl/en-us/devg-cse/cse_devg_0002.html
[CSE Developer Guide]: https://support.huaweicloud.com/intl/en-us/productdesc-cse/cse_productdesc_0001.html
[SERVICECOMB]: https://servicecomb.apache.org/developers/
[NACOS]: https://nacos.io/zh-cn/index.html
[Service Registry]: https://support.huaweicloud.com/intl/en-us/devg-servicestage/ss-devg-0017.html
Expand All @@ -53,3 +61,10 @@ Spring Cloud Huawei provides a large number of out-of-the-box service governance
[Canary release features]: https://support.huaweicloud.com/devg-servicestage/ss-devg-0023.html
[Profile encryption scheme]: https://support.huaweicloud.com/bestpractice-cse/cse_bestpractice_0007.html
[Spring Cloud Releases]: https://github.com/spring-cloud/spring-cloud-release/wiki/Supported-Versions
[Spring Cloud Huawei Releases]: https://github.com/huaweicloud/spring-cloud-huawei/wiki/third-version-support-descriptions

## Star this project

If you like this project, do not forget star it.

[![Star History Chart](https://api.star-history.com/svg?repos=huaweicloud/spring-cloud-huawei&type=Date)](https://star-history.com/#huaweicloud/spring-cloud-huawei&Date)
26 changes: 18 additions & 8 deletions README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,20 +18,28 @@ Spring Cloud Huawei提供了大量开箱即用的服务治理能力,让开发

## 支持的版本列表

| 分支 | 最新版本 | 编译使用 Spring Cloud版本 | 编译使用 Spring Boot版本 |
|-----------|-----------------|---------------------|--------------------|
| master | 1.11.4-2021.0.x | 2021.0.8 | 2.7.17 |
| 2020.0.x | 1.10.8-2020.0.x | 2020.0.6 | 2.5.14 |
| Hoxton | 1.9.3-Hoxton | Hoxton.SR9 | 2.3.5.RELEASE |
| Greenwich | 1.6.3-Greenwich | Greenwich.SR6 | 2.1.6-RELEASE |
| 分支 | 最新版本 | 编译使用 Spring Cloud版本 | 编译使用 Spring Boot版本 | 支持的JDK版本 | 备注 |
|-----------|----------------------|---------------------|--------------------|------------|------|
| master | 1.11.13-2024.0.x(推荐) | 2024.0.2 | 3.4.12 | OpenJDK 17 | |
| 2023.0.x | 1.11.13-2023.0.x(推荐) | 2023.0.6 | 3.3.13 | OpenJDK 17 | |
| 2022.0.x | 1.11.11-2022.0.x(推荐) | 2022.0.5 | 3.1.12 | OpenJDK 17 | 停止更新 |
| 2021.0.x | 1.11.13-2021.0.x(推荐) | 2021.0.9 | 2.7.18 | OpenJDK 8 | 存在漏洞 |
| 2020.0.x | 1.10.8-2020.0.x | 2020.0.6 | 2.5.14 | OpenJDK 8 | 停止更新 |
| Hoxton | 1.9.4-Hoxton | Hoxton.SR9 | 2.3.5.RELEASE | OpenJDK 8 | 停止更新 |
| Greenwich | 1.6.4-Greenwich | Greenwich.SR6 | 2.1.6-RELEASE | OpenJDK 8 | 停止更新 |
| Finchley | 1.6.1-Finchley | 2.0.4.RELEASE | 2.0.9.RELEASE | OpenJDK 8 | 停止更新 |
| Edgware | 1.2.0-Edgware | 1.3.6.RELEASE | 1.5.22.RELEASE | OpenJDK 8 | 停止更新 |

***注意:***
* 尽快更新到Spring社区维护的OOS版本2023.0.x/2024.0.x分支,因为2021.0.x分支依赖的Spring 5.3.x存在一定的漏洞,暂时未提供开源版本修复。
* 使用`Spring Cloud Huawei`时可以使用兼容的`Spring Cloud`版本。详细信息可参考 https://spring.io/projects/spring-cloud 。
* Spring Cloud Edgeware, Finchley, Greenwich, Hoxton 已经停止维护,不建议在生产环境使用。
* Spring Cloud Edgeware, Finchley, Greenwich, Hoxton, 2020.0.x 已经停止维护,不建议在生产环境使用。
详细情况可以查询 [Spring Cloud Releases][Spring Cloud Releases]。
* Hoxton(包括)之前的版本支持Netfix OSS的组件,比如Ribbon, Hystrix. 2020.0.x(包括)之后的版本支持
Spring Cloud Loadbalancer.
* 2020.0.x(包括)之前的版本使用springfox生成swagger. 2021.0.x(包括)之后的版本使用springdoc生成swagger.
* 2022.0.x(包括)需要JDK 17+版本运行.
* Spring Cloud Huawei历史版本Spring Boot、Spring Cloud依赖说明参考 [版本说明][Spring Cloud Huawei Releases].

## 如何使用

Expand All @@ -44,7 +52,7 @@ Spring Cloud Huawei提供了大量开箱即用的服务治理能力,让开发

[CSE]: https://support.huaweicloud.com/cse/index.html

[CSE Developer Guide]: https://support.huaweicloud.com/devg-cse/cse_devg_0002.html
[CSE Developer Guide]: https://support.huaweicloud.com/productdesc-cse/cse_productdesc_0001.html

[SERVICECOMB]: https://servicecomb.apache.org/cn/developers/

Expand All @@ -61,3 +69,5 @@ Spring Cloud Huawei提供了大量开箱即用的服务治理能力,让开发
[Profile encryption scheme]: https://support.huaweicloud.com/bestpractice-cse/cse_bestpractice_0007.html

[Spring Cloud Releases]: https://github.com/spring-cloud/spring-cloud-release/wiki/Supported-Versions

[Spring Cloud Huawei Releases]: https://github.com/huaweicloud/spring-cloud-huawei/wiki/third-version-support-descriptions