Apache ServiceComb Saga
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github SCB-130 Updated the Github PR template Dec 26, 2017
acceptance-tests SCB-1111 Always init the table script if possible Jan 15, 2019
alpha SCB-1118 Catch the exception to keep EventScanner running Jan 20, 2019
demo Try to fix the random failure of travis CI Jan 11, 2019
distribution Updated the project version for next development Dec 29, 2018
docker-build-config Updated the project version for next development Dec 29, 2018
docs SCB-1100 Updated the user guilde for migration from saga 0.2.x Jan 2, 2019
integration-tests Updated the project version for next development Dec 29, 2018
omega SCB-1122 Added name on Omega related RestTemplateBean (#386) Jan 21, 2019
pack-common Updated the project version for next development Dec 29, 2018
pack-contracts SCB-1103 (WIP-3) TCC should have participation started and ended events Jan 13, 2019
persistence Updated the project version for next development Dec 29, 2018
scripts SCB-976 Tried to fix the travis build Dec 17, 2018
web Updated the project version for next development Dec 29, 2018
.gitignore Updated the .gitingore May 26, 2018
.travis.settings.xml Add Release Server ID Mar 6, 2018
.travis.yml Publish the snapshot without running test Oct 16, 2018
CONTRIBUTING.md Fixed the Contributing.md typo Jun 1, 2018
FAQ.md Add a FAQ list Mar 27, 2018
FAQ_ZH.md Update FAQ_ZH.md Dec 21, 2018
LICENSE Update license for web source Dec 29, 2018
NOTICE Updated NOTICE files Mar 10, 2018
README.md Update the README file Jan 3, 2019
README_ZH.md Update README_ZH.md Jan 4, 2019
ROADMAP.md Updated the ROAMAP with latest add tasks Nov 1, 2018
gpg-sec.tar.enc Prepare 1.0.0-m1 Release Mar 6, 2018
pom.xml Updated the project version for next development Dec 29, 2018

README.md

Pack | 中文 Build Status Coverage StatusMaven Central License Gitter

Apache ServiceComb Pack is an eventually data consistency solution for micro-service applications.

Features

  • High availability. The coordinator is stateless and thus can have multiple instances.
  • High reliability. All transaction events are stored in database permanently.
  • High performance. Transaction events are reported to coordinator via gRPC and transaction payloads are serialized/deserialized by Kyro.
  • Low invasion. All you need to do is add 2-3 annotations and the corresponding compensate methods.
  • Easy to deploy. All components can boot via docker.
  • Support both forward(retry) and backward(compensate) recovery.
  • Easy to extend other coordination protocol which is based on the Pack, now we have Saga and TCC support out of box.

Architecture

ServiceComb Pack is composed of alpha and omega.

  • The alpha plays as the coordinator. It is responsible for the management of transactions.
  • The omega plays as an agent inside the micro-service. It intercepts incoming/outgoing requests and reports transaction events to alpha.

The following diagram shows the relationships among alpha, omega and services. Pack Architecture

In this way, we can implement different coordination protocols, such as saga and TCC. See ServiceComb Pack Design for details.

Now we have different lanaguage implementation of Omega

Get Started

  • For ServiceComb Java Chassis application, please see Booking Demo for details.
  • For Spring applications, please see Booking Demo for details.
  • For Dubbo applications, please see Dubbo Demo for details.
  • For TCC with Spring application, please see Tcc Demo for details.
  • To debug the applications, please see Spring Demo Debugging for details.

Build and Run the tests from source

  • Build the source code and run the tests
       $ mvn clean install
  • Build the source demo docker images and run the accept tests
       $ mvn clean install -Pdemo,docker
  • Build the source code and docker images without running tests
       $ mvn clean install -DskipTests=true -Pdemo,docker
  • Current ServiceComb Pack code supports Spring Boot 1.x and Spring Boot 2.x at the same time, saga uses Spring Boot 1.x by default, you can use -Pspring-boot-2 to switch Spring Boot version to 2.x. Since Spring Boot supports JDK9 since 2.x, if you want to build and run test the Saga with JDK9 or JDK10, you need to use the spring-boot-2 profile.
       $ mvn clean install -Pdemo,docker,spring-boot-2

User Guide

How to build and use can refer to User Guide.

Get The Latest Version

Get released version:

Get snapshot version:

  • We publish the snapshot version to Apache nexus repo, please add below repositories into your pom.xml.
            <repositories>
              <repository>
                <releases />
                <snapshots>
                  <enabled>true</enabled>
                </snapshots>
                <id>repo.apache.snapshot</id>
                <url>https://repository.apache.org/content/repositories/snapshots/</url>
              </repository>
            </repositories>
            <pluginRepositories>
              <pluginRepository>
                <releases />
                <snapshots>
                  <enabled>true</enabled>
                </snapshots>
                <id>repo.apache.snapshot</id>
                <url>https://repository.apache.org/content/repositories/snapshots/</url>
              </pluginRepository>
            </pluginRepositories>
         
              
    

FAQ

Contact Us

Contributing

See Pull Request Guide for details.

Stargazers over time

Stargazers over time

License

Licensed under an Apache 2.0 license.