You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Go to file
Haotian Zhang 8dfdb04a4d
Update README-zh.md
3 years ago
.github docs:add PULL_REQUEST_TEMPLATE.md 3 years ago
.mvn/wrapper feat:first commit 3 years ago
spring-cloud-starter-tencent-polaris-circuitbreaker feat:optimize project structure and checkstyle 3 years ago
spring-cloud-starter-tencent-polaris-discovery feat:update version number 3 years ago
spring-cloud-starter-tencent-polaris-ratelimit feat:optimize project structure and checkstyle 3 years ago
spring-cloud-starter-tencent-polaris-router feat:optimize project structure and checkstyle 3 years ago
spring-cloud-tencent-commons feat:optimize project structure and checkstyle 3 years ago
spring-cloud-tencent-coverage feat:optimize project structure and checkstyle 3 years ago
spring-cloud-tencent-dependencies feat:update version number 3 years ago
spring-cloud-tencent-examples feat:optimize project structure and checkstyle 3 years ago
spring-cloud-tencent-metadata fix:fix conflicts 3 years ago
spring-cloud-tencent-polaris-context feat:optimize project structure and checkstyle 3 years ago
src/checkstyle feat:optimize project structure and checkstyle 3 years ago
.editorconfig feat:optimize project structure and checkstyle 3 years ago
.gitignore feat:first commit 3 years ago
CONTRIBUTING.md feat:first commit 3 years ago
Code-of-Conduct.md docs:update Version Standard of README.md and fix maven dependencies bug. 3 years ago
LICENSE docs:update LICENSE 3 years ago
README-zh.md Update README-zh.md 3 years ago
README.md Update README.md 3 years ago
mvnw docs:update dependency 3 years ago
mvnw.cmd feat:first commit 3 years ago
pom.xml feat:update version number 3 years ago

README.md

Spring Cloud Tencent

Build Status Maven Central

English | 简体中文

Introduction

Spring Cloud Tencent contains components distributed micro-service applications need during developing phase, developers that built their key architectures based on Spring Cloud can use these components

Based on Spring Cloud Tencent, you only need a small configuration to launch Spring Cloud and micro-service's joint solutions.

Key Features

  • Service Registration and Discovery: Based on Spring Cloud's discovery and registration standard.
  • Service Routing and LoadBalancer: Based on ribbon's API port, provide dynamic routing and load balancing use cases.
  • CircuitBreaker Node: Support circuitbreaker auto-reset ability, ensure the reliability of distributed server
  • Rate Limiter: Support rate limit of microservice and gateway, ensure the stability of backend, one can configure policies and traffic data from the control panel
  • Metadata Delivery: Support metadata delivery between gateways and microservices.

Components

PolarisPolaris Spring Cloud operation centre, provide solutions to registration, dynamic routing, load balancing and circuitbreaker.

How to build

  • master's branch matches Spring Cloud Hoxton, support lowest at JDK 1.8.

Spring Cloud Tencent uses Maven to construct, the fastest way is to clone project to local files, then execute the following orders:

./mvnw install

When all the steps are finished, the project will be installed in local Maven repository.

How to Use

How to Introduce Dependency

Add the following configurations in dependencyManagement, then add the dependencies you need. At the same time, you need to pay attention to the Spring Cloud version corresponding to Spring Cloud Tencent, and then the corresponding Spring Boot version. For example, Spring Cloud Tencent's 1.0.1.Hoxton.SR9 corresponds to the Spring Cloud Hoxton version and requires Spring Boot 2.3.x.

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.tencent.cloud</groupId>
                <artifactId>spring-cloud-tencent-dependencies</artifactId>
                <!--version number-->
                <version>${version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

Example

Spring Cloud Tencent project contains a sub-module spring-cloud-tencent-examples. This module provides examples for users to experience, you can read the README.md in each example, and follow the instructions there.

Example List:

For more features, please refer to 使用polaris-java.

Version Standard

We use a version policy related to Spring Cloud's major version number.

Project version includes ${MAJOR_VERSION}.${MINOR_VERSION}.${PATCH_VERSION}.${CORRESPONDING_MAJOR_VERSION_OF_SPRING_CLOUD}.${CORRESPONDING_MINOR_VERSION_OF_SPRING_CLOUD}-${RELEASE_TYPE}. ${MAJOR_VERSION}, ${MINOR_VERSION}, ${PATCH_VERSION} are in numbers starting from 0. ${CORRESPONDING_MAJOR_VERSION_OF_SPRING_CLOUD} is the same as the major version number of Spring Cloud, like Hoxton, Greenwich. ${CORRESPONDING_MINOR_VERSION_OF_SPRING_CLOUD} is the same as the major version number of Spring Cloud, like RS9. ${RELEASE_TYPE} is like RELEASE or RC currently. Actually, the RELEASE version does not add a release type in the version, and the RS version will add a suffix and start from RC0.

For example: 1.2.0-Hoxton.SR9-RC0

License

The spring-cloud-tencent is licensed under the BSD 3-Clause License. Copyright and license information can be found in the file LICENSE