Awesome Open Source
Awesome Open Source

Build Status codecov

Microservices example

There are articles with more detailed explanation about this project: in English and in Russian.

This is an example of microservice architecture pattern implemented with following stack of Java-technologies:

  • JDK 13
  • Kotlin
  • Spring Cloud
    • Spring Cloud Gateway
    • Spring Cloud Config
    • Spring Cloud Sleuth
    • Spring Cloud OpenFeign
    • Spring Cloud Netflix
      • Eureka
      • Hystrix
      • Ribbon
  • Gradle with Kotlin DSL
  • JUnit
  • Other: Thymeleaf, Bootstrap, Webjars

Diagram of components


Config server

Stores configs of all microservices.

Service discovery server

Performs Service registry function. Spring Cloud Netflix Eureka is used which is Client-side service discovery. Each application sends heartbeats to Eureka server after registration.

Items service

This is an example of back-end with REST API implemented with Spring WebFlux. HTTP requests are processed with handler. Also microservice demonstrates example of sending additional metadata.

Items UI

This is an example of front-end which uses Thymeleaf for HTML-pages rendering and Bootstrap CSS framework (plugs in with help of Webjars). Application contains a few examples of interacting with back-end (Items service) by using different API:

You can test all of these approaches by request to http://localhost:8081/example.

You can test Hystrix fallback working by request to http://localhost:8081/hystrix-fallback.

UI gateway

Performs authentication and routing to UI microservices (only Items UI in this project). Routing implemented with Spring Cloud Gateway which settings as well as other settings are stored in YAML-config. Also application contains route to Eureka accessed by https://localhost/eureka. All routes you can see by request to https://localhost/actuator/gateway/routes. Access to login page implements using WebFlux. You can perform authentication with one of hardcoded users. Application passes user's login and roles by adding it to HTTP request headers. You can request to https://localhost/items-ui/greeting to see passed credentials. Sure you can access all other endpoints provided by Items UI. As well as Items UI this application uses Thymeleaf and Bootstrap for UI purposes.


ui-gateway works on port 443 and is available with HTTPS protocol. SSL certificate was created by using following command:

keytool -genkey -alias test_key -storetype PKCS12 -keyalg RSA -keysize 2048 -keystore keystore.p12 -validity 3650

and with qwerty password.

Distributed tracing


This schema is simple, see here for details.


Depending of your OS: gradlew clean build or ./gradlew clean build.

Used Gradle 5 requires at least JDK 8.


Run all microservices in the same order as they are listed. If you are using Intellij IDEA with enabled Run Dashboard you should get something like:


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
kotlin (3,582
spring-boot (766
microservices (455
microservice (370
gradle (345
spring-cloud (212
microservices-architecture (76
thymeleaf (60
eureka (53
hystrix (43
feign (28
webflux (24
spring-boot-2 (20
spring-cloud-netflix (16