|
|
|
|
@ -11,48 +11,53 @@
|
|
|
|
|
|
|
|
|
|
English | [简体中文](./README-zh.md)
|
|
|
|
|
|
|
|
|
|
README:
|
|
|
|
|
|
|
|
|
|
- [Introduction](#introduction)
|
|
|
|
|
- [How to build](#how-to-build)
|
|
|
|
|
- [How to use](#how-to-use)
|
|
|
|
|
- [Examples](#examples)
|
|
|
|
|
|
|
|
|
|
Visit [Wiki](https://github.com/Tencent/spring-cloud-tencent/wiki) to learn more
|
|
|
|
|
|
|
|
|
|
## Introduction
|
|
|
|
|
|
|
|
|
|
Spring Cloud Tencent is a open source one-stop microservice solution from Tencent.
|
|
|
|
|
Spring Cloud Tencent is an one-stop microservice solution which implements the standard Spring Cloud SPI. It integrates
|
|
|
|
|
Spring Cloud with Tencent middlewares and makes it easy to develop microservice.
|
|
|
|
|
|
|
|
|
|
<img src="https://user-images.githubusercontent.com/4991116/170412596-692f8dae-42f7-495f-a451-01396e381eb0.png" width="80%" />
|
|
|
|
|
|
|
|
|
|
Spring Cloud Tencent implements the Spring Cloud standard microservice SPI, so developers can quickly develop Spring
|
|
|
|
|
Cloud cloud-native distributed applications based on Spring Cloud Tencent.
|
|
|
|
|
**Service discovery and governance**
|
|
|
|
|
|
|
|
|
|
The core of Spring Cloud Tencent relies on Tencent's open-source one-stop service discovery and governance
|
|
|
|
|
platform [PolarisMesh](https://polarismesh.cn) to realize various distributed microservice scenarios.
|
|
|
|
|
Spring Cloud Tencent integrates Spring Cloud with Polaris which is an open source system for service discovery and
|
|
|
|
|
governance.
|
|
|
|
|
|
|
|
|
|
- [PolarisMesh Github home page](https://github.com/polarismesh/polaris)
|
|
|
|
|
- [PolarisMesh official website](https://polarismesh.cn/)
|
|
|
|
|
- [Polaris Github](https://github.com/polarismesh/polaris)
|
|
|
|
|
|
|
|
|
|
The capabilities provided by Spring Cloud Tencent include but are not limited to:
|
|
|
|
|
Spring Cloud with Polaris can solve these problem:
|
|
|
|
|
|
|
|
|
|
<img width="1031" alt="image" src="https://user-images.githubusercontent.com/4991116/170412596-692f8dae-42f7-495f-a451-01396e381eb0.png">
|
|
|
|
|
- service management: service discovery, service registry and health check
|
|
|
|
|
- traffic control: customizable routing, load balance, rate limiting and access control
|
|
|
|
|
- fault tolerance: circuit breaker for service, interface and instance
|
|
|
|
|
- config management: config version control, grayscale release and dynamic update
|
|
|
|
|
|
|
|
|
|
- Service registration and discovery
|
|
|
|
|
- Dynamic configuration management
|
|
|
|
|
- Service Governance
|
|
|
|
|
- Service rate limit
|
|
|
|
|
- Service circuit breaker
|
|
|
|
|
- Service routing
|
|
|
|
|
- ...
|
|
|
|
|
- Label transparent transmission
|
|
|
|
|
## How to build
|
|
|
|
|
|
|
|
|
|
## Demo Environment
|
|
|
|
|
Run these commands to build this project as follow.
|
|
|
|
|
|
|
|
|
|
- Console Address : http://14.116.241.63:8080/
|
|
|
|
|
- Username: polaris
|
|
|
|
|
- Password: polaris
|
|
|
|
|
- Server Address: `grpc://183.47.111.80:8091`
|
|
|
|
|
**Linux and Mac**
|
|
|
|
|
|
|
|
|
|
The example addresses under `spring-cloud-tencent-example` all point to the experience service
|
|
|
|
|
address (`grpc://183.47.111.80:8091`) by default. If you only experience Spring Cloud Tencent, you can run any example
|
|
|
|
|
directly with one click.
|
|
|
|
|
```
|
|
|
|
|
./mvnw clean package
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Screenshots
|
|
|
|
|
**Windows**
|
|
|
|
|
|
|
|
|
|
<img width="1727" alt="sc" src="https://user-images.githubusercontent.com/4991116/197529819-78b20ba8-0e60-450c-a8e3-0c2bf04caa15.png">
|
|
|
|
|
```
|
|
|
|
|
.\mvnw.cmd clean package
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Use Guide
|
|
|
|
|
## How to use
|
|
|
|
|
|
|
|
|
|
All the components of Spring Cloud Tencent have been uploaded to the Maven central repository, just need to introduce
|
|
|
|
|
dependencies.
|
|
|
|
|
@ -76,7 +81,7 @@ For example:
|
|
|
|
|
<groupId>com.tencent.cloud</groupId>
|
|
|
|
|
<artifactId>spring-cloud-tencent-dependencies</artifactId>
|
|
|
|
|
<!--version number-->
|
|
|
|
|
<version>1.11.6-Hoxton.SR12</version>
|
|
|
|
|
<version>1.11.7-Hoxton.SR12</version>
|
|
|
|
|
<type>pom</type>
|
|
|
|
|
<scope>import</scope>
|
|
|
|
|
</dependency>
|
|
|
|
|
@ -93,32 +98,25 @@ For example:
|
|
|
|
|
|
|
|
|
|
````
|
|
|
|
|
|
|
|
|
|
## Develop Guide
|
|
|
|
|
|
|
|
|
|
You can build this project with command:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
## MacOS or Linux
|
|
|
|
|
./mvnw clean package
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
## Win
|
|
|
|
|
.\mvnw.cmd clean package
|
|
|
|
|
```
|
|
|
|
|
The experience environment of Polaris is provided for developers:
|
|
|
|
|
|
|
|
|
|
## Documents
|
|
|
|
|
- [Polaris Console](http://119.91.66.223:80)
|
|
|
|
|
- Polaris Server Address: `grpc://119.91.66.223:8091`
|
|
|
|
|
|
|
|
|
|
Pelease refer to [Wiki](https://github.com/Tencent/spring-cloud-tencent/wiki)
|
|
|
|
|
The address of Polaris server in spring-cloud-tencent-example is `grpc://119.91.66.223:8091` by default.
|
|
|
|
|
|
|
|
|
|
## Chat Group
|
|
|
|
|
|
|
|
|
|
Please scan the QR code to join the chat group.
|
|
|
|
|
|
|
|
|
|
<img src="https://user-images.githubusercontent.com/24446200/169198148-d4cc3494-3485-4515-9897-c8cb5504f706.png" width="30%" height="30%" />
|
|
|
|
|
<img src="https://user-images.githubusercontent.com/24446200/169198148-d4cc3494-3485-4515-9897-c8cb5504f706.png" width="20%" height="20%" />
|
|
|
|
|
|
|
|
|
|
If the above QR code fails, please scan the QR code to add WeChat, and send "Spring Cloud Tencent" to apply for joining the group.
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
<img src="https://github.com/Tencent/spring-cloud-tencent/assets/24446200/77912670-aa7b-44ec-a312-42a05d59b109" width=20% height=20%>
|
|
|
|
|
|
|
|
|
|
The spring-cloud-tencent is licensed under the BSD 3-Clause License. Copyright and license information can be found in
|
|
|
|
|
the file [LICENSE](LICENSE)
|
|
|
|
|
|
|
|
|
|
## Stargazers over time
|
|
|
|
|
|
|
|
|
|
|
Haotian Zhang
2 years ago