README.md

Read Me First

The following was discovered as part of building this project:

• This documentation is part of training for maybank project.

Concept of Microservices

• Microservice Architecture
  • https://aws.amazon.com/microservices/
  • https://dzone.com/articles/top-5-microservices-architecture-and-design-best-p
  • https://towardsdatascience.com/microservice-architecture-and-its-10-most-important-design-patterns-824952d7fa41
  • https://javarevisited.blogspot.com/2021/09/microservices-design-patterns-principles.html

Getting Started

Requirement

• step 1. (OPTIONAL) docker run --name mbb-local-postgres -d -p 5432:5432 -e POSTGRES_PASSWORD=postgres postgres:alpine
• step 2. Java 8 and above
• step 3. Postman
• Step 4. Maven

Step to run the services

step 1. Run registry-server

• mvn clean compile spring-boot:run

step 2. Run config-server

• mvn clean compile spring-boot:run -Dspring.profiles.active=dev

step 3. Run master-data-service

• mvn clean compile spring-boot:run

step 4. Test in postman

• POSTMAN - Use this link to run the API (https://www.postman.com/lively-moon-579376/workspace/public/collection/19577438-286c3385-e4f1-476e-a73b-86202fdfdda0?action=share&creator=19577438)

Server info

• MBB-API-GATEWAY-SERVICE | Port: 8881
• MBB-REGISTRY-SERVER | Port: 8761
• MBB-CONFIG-SERVER | Port: 8888
• MBB-MASTER-DATA-SERVICE | Port: 8082 (NO NEED TO POINT TO THIS PORT AS WE USED THE API GATEWAY)

Step to change database configuration

step 1. Run config-server

step 2. Change below configuration in path <mbb-config-server/src/main/resources/config-repo/application-dev.properties>

spring.datasource.url=jdbc:postgresql://localhost:5432/postgres
spring.database.scheme=mbb_core
spring.datasource.username=postgres
spring.datasource.password=postgres

Step to install Redis in docker

step 1. docker network create -d bridge redisnet

step 2. docker run -d -p 6379:6379 --name myredis --network redisnet redis

step 3. brew install redis

step 4. brew tap ringohub/redis-cli

code reference: https://developer.redis.com/develop/java/redis-and-spring-course/lesson_2/

Guideline Traning Documentation

• Spring Cloud (https://spring.io/projects/spring-cloud)
  • Spring Cloud Netflix
  • Spring Cloud Config
  • Spring Cloud OpenFeign
  • Spring Cloud Connector (MQ)
  • Spring Cloud Security
  • Spring Cloud Gateway
  • Zuul Gateway
• Spring Data (https://spring.io/projects/spring-data)
  • Spring Data JDBC
  • Spring Data JPA
  • Spring Data Redis
• Monitor
  • Elastic Logstash
  • Prometheus
  • Datadog
• Others
  • https://projectlombok.org
  • Swagger (https://swagger.io/docs/)
  • Kubernetes / Docker
    • https://kubernetes.io/docs/home/
    • https://www.docker.com/get-started/

Reference Documentation

For further reference, please consider the following sections:

• Official Apache Maven documentation
• Spring Boot Maven Plugin Reference Guide
• Create an OCI image
• Spring Web
• Spring Data JPA
• Spring Data JDBC
• Config Client Quick Start
• Eureka Discovery Client

Guides

The following guides illustrate how to use some features concretely:

• Building a RESTful Web Service
• Serving Web Content with Spring MVC
• Building REST services with Spring
• Accessing Data with JPA
• Using Spring Data JDBC
• Service Registration and Discovery with Eureka and Spring Cloud