https://github.com/piomin/sample-spring-microservices-transactions

Spring Boot Demo with microservices that performs distributed transactions
https://github.com/piomin/sample-spring-microservices-transactions

distributed-transactions microservices postgresql spring-boot spring-data spring-data-jpa transactional

Last synced: 6 days ago
JSON representation

Spring Boot Demo with microservices that performs distributed transactions

• Host: GitHub
• URL: https://github.com/piomin/sample-spring-microservices-transactions
• Owner: piomin
• Created: 2020-06-19T10:11:26.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-12-19T18:03:34.000Z (23 days ago)
• Last Synced: 2024-12-29T22:25:23.539Z (13 days ago)
• Topics: distributed-transactions, microservices, postgresql, spring-boot, spring-data, spring-data-jpa, transactional
• Language: Kotlin
• Homepage: https://piotrminkowski.com
• Size: 94.7 KB
• Stars: 87
• Watchers: 5
• Forks: 52
• Open Issues: 8
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# Distributed transactions in microservices Demo Project [![Twitter](https://img.shields.io/twitter/follow/piotr_minkowski.svg?style=social&logo=twitter&label=Follow%20Me)](https://twitter.com/piotr_minkowski)

[![CircleCI](https://circleci.com/gh/piomin/sample-spring-microservices-transactions.svg?style=svg)](https://circleci.com/gh/piomin/sample-spring-microservices-transactions)

[![SonarCloud](https://sonarcloud.io/images/project_badges/sonarcloud-black.svg)](https://sonarcloud.io/dashboard?id=piomin_sample-spring-microservices-transactions)

[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=piomin_sample-spring-microservices-transactions&metric=bugs)](https://sonarcloud.io/dashboard?id=piomin_sample-spring-microservices-transactions)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=piomin_sample-spring-microservices-transactions&metric=coverage)](https://sonarcloud.io/dashboard?id=piomin_sample-spring-microservices-transactions)

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=piomin_sample-spring-microservices-transactions&metric=ncloc)](https://sonarcloud.io/dashboard?id=piomin_sample-spring-microservices-transactions)

In this project I'm demonstrating a simple architecture of microservices that perform distributed transactions. The example application applications are simple Spring Boot app that expose some HTTP endpoints for CRUD operations and connects to Postgres using Spring Data JPA.

## Getting Started 

All the examples are described in a separated articles on my blog. Here's a full list of available examples:

1. Rollback or confirmation of distributed transaction across order-service, account-service and product-service. A detailed guide may be find in the following article: [Distributed Transaction in Microservices with Spring Boot](https://piotrminkowski.com/2020/06/19/distributed-transactions-in-microservices-with-spring-boot/)

## Usage

1. Start discovery-server. It is available on port 8761.

2. Start RabbitMQ on Docker with command `docker run -d --name rabbit -h rabbit -p 5672:5672 -p 15672:15672 rabbitmq:3-management`

3. Start transaction-server

4. Start Postgres on Docker with command `docker run -d --name postgres -p 5432:5432 -e POSTGRES_USER=trx -e POSTGRES_PASSWORD=trx123 -e POSTGRES_DB=trx postgres`

4. Start microservices: account-service, product-service and order-service. The app order-service is listening on port 8080.

5. Add some test data to product-service and account-service

5. Send some tests requests. For example: `$ curl http://localhost:8080/orders -H "Content-Type: application/json" -d "{\"productId\":1, \"count\":10, \"customerId\":1}"`

## Docker

You can test all the apps on Docker. To do that first build the whole project using the following command:

```shell

$ mvn clean package -DskipTests -Pbuild-image

```

Then you can just run all the apps including RabbitMQ and Postgres with `docker-compose`:

```shell

$ docker compose up

```