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
lambdaxiao 47e23f2b15
补充单测&&规范doc
3 years ago
.github docs:add PULL_REQUEST_TEMPLATE.md 3 years ago
.mvn/wrapper feat:first commit 3 years ago
spring-cloud-tencent-coverage docs:update dependencies 3 years ago
spring-cloud-tencent-dependencies 支持获取namespace下的全部service列表 3 years ago
spring-cloud-tencent-docs docs:add configuration of namespace in docs 3 years ago
spring-cloud-tencent-examples optimize quickstart document 3 years ago
spring-cloud-tencent-starters 补充单测&&规范doc 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 feat: add quick-start examples, change polaris-java to 1.2.1 3 years ago
README.md fix:fix context configuration NPE when using standalone polaris 3 years ago
mvnw docs:update dependency 3 years ago
mvnw.cmd feat:first commit 3 years ago
pom.xml docs:optimize Maven dependencies 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.0.1.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