hunny-lh/vertx-blueprint-microservice

Vert.x blueprint application - Micro-Shop microservice application

Vert.x Microservice Blueprint

Vert.x blueprint application - An online shopping microservice application developed with Vert.x. This repo is intended to be an illustration on how to develop microservice applications using Vert.x toolkit.

Content

• Microservice with Vert.x
• Asynchronous development model
• Reactive and functional pattern
• Event sourcing
• Asynchronous RPC on the clustered event bus
• Various type of services (e.g. REST, message source, data source)
• Service discovery
• Circuit breaker
• Polyglot persistence support
• API gateway
• Global authentication (OAuth 2 + Keycloak)

Documentation

Detailed tutorials are available here!

• English Version
  • Vert.x Blueprint - Micro Shop microservice practice (Development)
  • Vert.x Blueprint - Micro Shop microservice practice (API Gateway)
• 中文版本
  • Vert.x 蓝图 - Micro Shop 微服务实战 (开发篇)
  • Vert.x 蓝图 - Micro Shop 微服务实战 (API Gateway)

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

To run the microservice with Docker Compose, please refer to the run instruction.

Contributing

Contributions are definitely welcome !