manju07 / java-spring-boot-microservice-app

Sample microservice architecture application using java8, spring boot, and spring cloud.

Microservice Application

This application is built on Spring Boot, Spring Cloud, Cloud-Config, Eureka Naming server, Zuual API gateway, OAuth-2, Swagger, and MySql DB.

Note:

• We are using a GitHub repo for managing service config properties files. please clone below repo before running this application locally - github repo link

• To run MySql locally with docker, please refer to this document, it is part of this repo java-spring-boot-microservice-app/dbSetup.md

Microservices

cloud-config-server

This will provide the service config property during runtime basis on the environment/configured at the service level.

As you are cloning the repo, you need to specify the repo path in this file cloud-config-server/src/main/resources/application-dev.properties.

spring.cloud.config.server.git.uri=file:/path_to_git_repo

eureka-naming Server

We register all our microservices to track the health status and provide other service details for communication.

oauth2-authentication-server

This will perform the authentication and authorization based on roles assigned to the users.

user-service

This will be managing the users across all corporates on the basis of roles.

group-service

This will be managing the badges, and teams for all corporates.

zuul-api-gateway Server

This is a publicly exposed service, all requests are routed to different services one based on regex.

How to set up locally?

• Dependencies for local setup - Visual Code/IntelliJ/Eclipse, Maven, JDK8, MySql Database, Docker, Thunderclient/Postman.

• We are using a GitHub repo for managing service config properties files. please clone the below repo before running this application locally.

  • https://github.com/manju07/java-spring-boot-microservice-app-config

• DB Setup - To run MySql locally with docker, please refer to this document which is part of this repo java-spring-boot-microservice-app/dbSetup.md

• 2 ways to run this application.

  • Docker thru

    • Get into the main directory folder, and run the command "mvn clean package". this will build all modules and docker images. then execute run.sh.

  • Spring boot thru

    • Run each service in the below order.
      • cloud-config-server
      • eureka-naming-server
      • oauth2-authentication-server
      • group-service
      • user-service
      • zuul-api-gateway-server

• You can test by checking this swagger - http://localhost:8765/swagger-ui.html

Important Resources

• Postman Collections - java-spring-boot-microservice-app/postman-collection_sample-app_postman.json

• Thunderclient Collections - java-spring-boot-microservice-app/thunder-collection_sample-app.json

• Swagger Documentation - http://localhost:8765/swagger-ui.html

Author - Manjunath Asundi
EmailId:[email protected]