Spring Cloud Alibaba provides a one-stop solution for application development for the distributed solutions of Alibaba middleware.
Switch branches/tags
Clone or download
Latest commit 0d88d81 Nov 17, 2018
Permalink
Failed to load latest commit information.
.circleci Adds spring profile to circleci Oct 23, 2018
.mvn upload maven-wrapper.jar to fix error in execute mvnw & modify branch… Jul 27, 2018
spring-cloud-alibaba-dependencies Merge pull request #109 from pbting/master Nov 16, 2018
spring-cloud-alibaba-docs 更改Nacos Config 的 Reference 文档 Nov 15, 2018
spring-cloud-alibaba-examples Add ANS and ACM readme doc. Nov 8, 2018
spring-cloud-alibaba-nacos-config-server update parent version Nov 17, 2018
spring-cloud-alibaba-nacos-config Update to 0.2.1.BUILD-SNAPSHOT Oct 30, 2018
spring-cloud-alibaba-nacos-discovery fixes #87. Nov 3, 2018
spring-cloud-alibaba-sentinel-datasource Update to 0.2.1.BUILD-SNAPSHOT Oct 30, 2018
spring-cloud-alibaba-sentinel Update to 0.2.1.BUILD-SNAPSHOT Oct 30, 2018
spring-cloud-alibaba-test Update to 0.2.1.BUILD-SNAPSHOT Oct 30, 2018
spring-cloud-alicloud-acm Update to 0.2.1.BUILD-SNAPSHOT Oct 30, 2018
spring-cloud-alicloud-ans Update to 0.2.1.BUILD-SNAPSHOT Oct 30, 2018
spring-cloud-alicloud-context Update to 0.2.1.BUILD-SNAPSHOT Oct 30, 2018
spring-cloud-alicloud-oss Update to 0.2.1.BUILD-SNAPSHOT Oct 30, 2018
spring-cloud-starter-alibaba Update to 0.2.1.BUILD-SNAPSHOT Oct 30, 2018
spring-cloud-starter-alicloud Update to 0.2.1.BUILD-SNAPSHOT Oct 30, 2018
.gitignore fixes #87. Nov 3, 2018
LICENSE Initial commit Dec 1, 2017
README-zh.md 添加 Nacos Discovery 到 Reference 目录列表 Nov 15, 2018
README.md 添加 Nacos Discovery 到 Reference 目录列表 Nov 15, 2018
Roadmap-zh.md rename alibaba storage to alicloud storage Sep 26, 2018
Roadmap.md update readme Sep 15, 2018
mvnw hello, spring cloud alibaba Jul 27, 2018
mvnw.cmd hello, spring cloud alibaba Jul 27, 2018
pom.xml Merge branch 'master' into master Nov 16, 2018

README.md

Spring Cloud Alibaba

A project maintained by Alibaba.

See the 中文文档 for Chinese readme.

Spring Cloud Alibaba provides a one-stop solution for distributed application development. It contains all the components required to develop distributed applications, making it easy for you to develop your applications using Spring Cloud.

With Spring Cloud Alibaba,you only need to add some annotations and a small amount of configurations to connect Spring Cloud applications to the distributed solutions of Alibaba, and build a distributed application system with Alibaba middleware.

Features

  • Flow control and service degradation:Flow control for HTTP services is supported by default. You can also customize flow control and service degradation rules using annotations. The rules can be changed dynamically.
  • Service registration and discovery:Service can be registered and clients can discover the instances using Spring-managed beans, auto integration Ribbon.
  • Distributed configuration:support for externalized configuration in a distributed system, auto refresh when configuration changes.
  • AliCloud Object Storage:massive, secure, low-cost, and highly reliable cloud storage services. Support for storing and accessing any type of data in any application, anytime, anywhere. For more features, please refer to Roadmap.

Components

Sentinel: Sentinel takes "traffic flow" as the breakthrough point, and provides solutions in areas such as flow control, concurrency, circuit breaking, and load protection to protect service stability.

Nacos: an easy-to-use dynamic service discovery, configuration and service management platform for building cloud native applications.

AliCloud OSS: An encrypted and secure cloud storage service which stores, processes and accesses massive amounts of data from anywhere in the world.

For more features please refer to Roadmap.

How to build

  • master branch: Corresponds to Spring Boot 2.x. JDK 1.8 or later versions are supported.
  • 1.x branch: Corresponds to Spring Boot 1.x,JDK 1.7 or later versions are supported.

Spring Cloud uses Maven for most build-related activities, and you should be able to get off the ground quite quickly by cloning the project you are interested in and typing:

./mvnw install

How to Use

Add maven dependency

Version 0.2.0.RELEASE is compatible with the Spring Boot 2.0.x line. Version 0.1.0.RELEASE is compatible with the Spring Boot 1.x line.

These artifacts are available from Maven Central and Spring Release repository via BOM:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>0.2.0.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

add the module in dependencies.

If you want to use the latest BUILD-SNAPSHOT version, add Spring Snapshot Repository in pom.xml , Attention: BUILD-SNAPSHOT may be updated in any time

<repositories>
    <repository>
        <id>spring-snapshot</id>
        <name>Spring Snapshot Repository</name>
        <url>https://repo.spring.io/snapshot</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

Reference Doc

Contents

Nacos Config

Nacos Discovery

ACM

Examples

A spring-cloud-alibaba-examples module is included in our project for you to get started with Spring Cloud Alibaba quickly. It contains an example, and you can refer to the readme file in the example project for a quick walkthrough.

Examples:

Sentinel Example

Nacos Config Example

Nacos Discovery Example

AliCloud OSS Example

Version control guidelines

The version number of the project is in the form of x.x.x, where x is a number, starting from 0, and is not limited to the range 0~9. When the project is in the incubator phase, the first version number is fixed to 0, that is, the version number is 0.x.x.

As the interfaces and annotations of Spring Boot 1 and Spring Boot 2 have been changed significantly in the Actuator module, and spring-cloud-commons is also changed quite a lot from 1.x.x to 2.0.0, we maintain two different branches to support Spring Boot 1 and Spring Boot 2:

  • 0.1.x for Spring Boot 1
  • 0.2.x for Spring Boot 2

During the incubation period,the version management of the project will follow these rules:

  • Functional updates will be reflected in the 3rd number of the version, for example, the next version of 0.1.0 will be 0.1.1。

Contact Us

Mailing list is recommended for discussing almost anything related to spring-cloud-alibaba.

spring-cloud-alibaba@googlegroups.com:You can ask questions here if you encounter any problem when using or developing spring-cloud-alibaba.