Skip to content

Latest commit

 

History

History
187 lines (129 loc) · 7.7 KB

README.md

File metadata and controls

187 lines (129 loc) · 7.7 KB

GitHub license

e-shop

This project is inspired by eShopOnContainers and it's built to demonstrate features of Spring Cloud for implementing microservices architecture. In this project you can find examples of:

  • Spring Cloud Config
  • Eureka Service Discovery
  • Spring Cloud Gateway
  • Spring Cloud Circuit Breaker
  • Resilience4j
  • Spring Cloud Sleuth
  • Spring Cloud Stream
  • Spring Kafka
  • Kafka Streams API
  • Keycloak
  • Event Sourcing with Axon
  • GraphQL API with Netflix DGS
  • Angular
  • React and Apollo Client

Architectural Diagram

Assign Admin Role

Services

How To Run

You need to have Gradle 7+, Java 17+, Node.js and Docker. By default, Docker Desktop is set to use 2 GB runtime memory, allocated from the total available memory. We recommend setting the runtime memory to 6GB.

The best way to run the services is with IDEs like IntelliJ IDEA or Eclipse. Check their documentation for more details.

Run Infrastructural Components

Run all infrastructural containers(Postgres, Redis, Kafka, Keycloak authorization service) using the following command:

~ cd docker
~ docker-compose up

The keystore file on path docker/keycloak/auth-server.keystore is generated using the following command:

keytool -genkeypair -alias configkey -keyalg RSA \
  -dname "CN=authorization-service,C=MK,S=OH" \
  -keystore auth-server.keystore -storepass secure-keystore-password

Certificate file on path docker/base/sh/certificate.crt must be recreate when keystore changed.

Run micro-services

After you start the infrastructural components, you can run all micro-services using your favourite IDE. Check their corresponding documentation.

Keycloak https is enabled, so certificate must be imported before start micro-services.

Import cert

Use keytool to import certificate.

On linux like OS, you can excute shell here directly:

~ ./docker/base/sh/install-certs.sh

On other OS, you can do it with keytool easy.

Run micro-services with Docker

If you want to run the services with docker, first build the services with the following command:

~ ./gradlew clean build

Then:

  1. Run all infrastructure services Config, Discovery, API Gateway using the following command:

    ~ cd docker ~ docker-compose -f docker-compose.infra.yml up --build

  2. Run all domain services Order Processing, Catalog, Basket, Payment, Order Grace Period Task, Order Notifications, Analytics, Rating using the following command:

    ~ cd docker ~ docker-compose -f docker-compose.services.yml up --build

Run imaging service

We use imgproxy service to resize images on-the-fly. It is a fast and secure standalone server for resizing and converting remote images.

All catalog item images are stored in Minio. Minio is an object storage server. It is compatible with Amazon S3, so it can be used with imgproxy.

The images are uploaded to Minio via Image Service.

If you don't run these services, the spa client won't be able to fetch catalog item images.

Run imgproxy and Minio services:

~ cd docker
~ docker-compose -f docker-compose.img.yml up

You can access Minio at http://localhost:8086, and imgproxy at http://localhost:8887.

ELK (optional)

We use ELK for log analysis.

Run ELK stack:

~ cd docker
~ docker-compose -f docker-compose.elk.yml up

Also, you should run all services with 'elk' profile.

Zipkin (optional)

Spring Cloud Sleuth and Zipkin are used for monitoring microservices.

Run Zipkin:

~ cd docker
~ docker-compose -f docker-compose.zipkin.yml up

To enable distributed tracing, run all services with 'distributed-tracing' profile.

Run Angular Client

This client application is implemented with Angular and uses API Gateway.

~ cd clients/ng-rest-client
~ npm install
~ npm start

You can access the client application at http://localhost:4200. You can stop some services such as basket, order processing, or analytics, and you will notice that you can still use the application without some of its features.

Run React Client

This client application is implemented with React and uses GraphQL API Gateway.

~ cd clients/react-graphql-client
~ yarn install
~ yarn start

You can access the client application at http://localhost:4201.

Run everything

Alternatively, you can run the system as described bellow.

You can run all docker containers and Spring applications by running the ./scripts/start.sh. By default, the script won't start ELK and Zipkin. If you want to use ELK and Zipkin, you can run the script as: ./scripts/start.sh --elk --distributed-tracing. To stop everything you can run ./scripts/stop.sh.

Create user

Before you start using the application, you need to create a user. You can access Keycloak authorization service at http://localhost:8080/auth Login with admin/admin, go to "Users", click "Add user" and fill in the necessary data.

Add User

After you save the user, go to "Credentials" to set a password.

Set Password

If you want to assign admin role to the user, go to "Role Mappings", select "admin" under "Available Roles" and click "Add selected".

Assign Admin Role

Contributing

The issue tracker is the preferred channel for bug reports and features requests. If you want to contribute please do not hesitate to submit a pull request.