https://github.com/sczyh30/vertx-blueprint-microservice
Vert.x Blueprint Project - Micro-Shop microservice application
https://github.com/sczyh30/vertx-blueprint-microservice
asynchronous docker event-driven-microservices event-sourcing microservice microservices vertx
Last synced: 8 months ago
JSON representation
Vert.x Blueprint Project - Micro-Shop microservice application
- Host: GitHub
- URL: https://github.com/sczyh30/vertx-blueprint-microservice
- Owner: sczyh30
- License: apache-2.0
- Created: 2016-04-26T04:01:33.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2018-12-13T19:50:35.000Z (almost 7 years ago)
- Last Synced: 2025-03-28T07:03:30.868Z (8 months ago)
- Topics: asynchronous, docker, event-driven-microservices, event-sourcing, microservice, microservices, vertx
- Language: Java
- Homepage:
- Size: 1.79 MB
- Stars: 778
- Watchers: 75
- Forks: 301
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- vertx-awesome - Vert.x blueprint - Microservice application - favicon.svg" alt="(stack)" title="Vert.x Stack" height="16px"> - The official Vert.x blueprint showing how to build a complex microservice application. (Examples)
- awesome-list-microservice - vertx-blueprint-microservice - Micro-Shop microservice application (vertx)
README
# Vert.x Microservice Blueprint
[](https://travis-ci.org/sczyh30/vertx-blueprint-microservice)
Vert.x blueprint application - A micro-shop microservice application developed with Vert.x.
This repo is intended to be an illustration on how to design microservice architecture and develop microservice applications using Vert.x.
This blueprint works with Vert.x **3.4.1**.
> Note: We are refactoring the whole architecture of the microservice blueprint.
This can take a long time and the improved new version is expected to be released
by the end of May. See [here](https://github.com/sczyh30/vertx-blueprint-microservice/issues/17) for details.
## Content
- Microservice with Vert.x
- Asynchronous development model
- Reactive and functional patterns
- Event sourcing patterns
- Asynchronous RPC on the clustered event bus
- Various type of services (e.g. REST, message source, event bus service)
- Configuration retriever
- Service discovery
- Circuit breaker
- Polyglot persistence support
- API gateway
- Global authentication (Local/OAuth 2)
- Centralized logging using ELK stack
- Monitoring
## Documentation
Detailed tutorials are available here!
- English Version
- [Vert.x Blueprint - Micro Shop microservice practice (Development)](http://sczyh30.github.io/vertx-blueprint-microservice/index.html)
- [Vert.x Blueprint - Micro Shop microservice practice (API Gateway)](http://sczyh30.github.io/vertx-blueprint-microservice/api-gateway.html)
- 中文版本
- [Vert.x 蓝图 - Micro Shop 微服务实战 (开发篇)](http://sczyh30.github.io/vertx-blueprint-microservice/cn/index.html)
- [Vert.x 蓝图 - Micro Shop 微服务实战 (API Gateway)](http://sczyh30.github.io/vertx-blueprint-microservice/cn/api-gateway.html)
## Architecture
## Build/Run
First, for `api-gateway` and `monitor-dashboard` component, you have to enter the `src/main/resources/webroot` directory and install the frontend dependencies with **bower**:
```
bower install
```
Then build the code:
```
mvn clean install -Dmaven.test.skip=true
```
To run the microservice with Docker Compose, please refer to the [running instruction](http://www.sczyh30.com/vertx-blueprint-microservice/index.html#show-time-).
## Contributing
Contributions are definitely welcome !