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

Sample microservice architecture application using java8, spring boot, and spring cloud.
https://github.com/manju07/java-spring-boot-microservice-app

cloud-config cloud-config-repo docker docker-compose docker-images eureka-discovery-service eureka-server java8 kubernetes lombok maven microservices microservices-application mysql oauth2-server spring-boot spring-cloud spring-security spring-security-oauth2 zuul-api-gateway

Last synced: about 10 hours ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/manju07/java-spring-boot-microservice-app
• Owner: manju07
• Created: 2020-10-04T03:56:28.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-02-24T07:10:24.000Z (9 months ago)
• Last Synced: 2024-02-25T05:34:07.582Z (9 months ago)
• Topics: cloud-config, cloud-config-repo, docker, docker-compose, docker-images, eureka-discovery-service, eureka-server, java8, kubernetes, lombok, maven, microservices, microservices-application, mysql, oauth2-server, spring-boot, spring-cloud, spring-security, spring-security-oauth2, zuul-api-gateway
• Language: Java
• Homepage:
• Size: 203 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
##  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](https://github.com/manju07/java-spring-boot-microservice-app-config)

- 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]