microservice-example's Introduction

Microservice Example based on Spring Cloud

This is an example project to demonstrate building micro-services using Spring Boot and Spring Cloud. The project demonstrates the following concepts :-

Microservice development using Spring Boot
Microservice discovery using Netflix Eureka (Spring Cloud)
API Gateway for orchestration between microservices
Routing using Netflix Zuul (Spring Cloud)
SSL communication between all the services
API documentation using Swagger
Correlation between microservices using Spring Cloud Sleuth
Containerisation of microservices using Docker (WIP)

How to run

Please visit the individual projects for instructions to run the components.

Discovery Server
Edge Server
Api Gateway
Book micro-service
Employee micro-service
Run the services in the following order :

discovery
edge
All other individual micro-services (book, employee etc.)
api-gateway

Architecture diagram

Security between services

HTTPS has been configured for the full service stack. The supported SSL version is TLS 1.2.

Edge Server -> API Gateway - One way SSL
API Gateway -> Microservices - Two way SSL (mutual authentication)
Services -> Discovery Server - One way SSL

Technology choices

The following technology choices have been made.

Edge Server - Netflix Zuul
Discovery Server - Netflix Eureka
API Gateway/Microservices - Spring Boot
Datastore - MongoDB

How to run using Docker - WIP

Clone the project
Build the parent project using : mvn clean install
Go to the docker folder under this project and run the command : docker compose up
Open http://localhost:8761/ in your browser to see the services registered to Eureka

Recommend Projects