June 7, 2019

699 words 4 mins read

vietnam-devs/coolstore-microservices

vietnam-devs/coolstore-microservices

A Kubernetes-based microservices application on service mesh

repo name vietnam-devs/coolstore-microservices
repo link https://github.com/vietnam-devs/coolstore-microservices
homepage https://vietnam-devs.github.io/coolstore-microservices
language C#
size (curr.) 45526 kB
stars (curr.) 1306
created 2018-06-01
license MIT License

CoolStore Web Application - :ferris_wheel: Kubernetes-based Microservices Application on Service Mesh :sailboat:

Travis (.org) Price OpenTracing Badge

 ______     ______     ______     __         ______     ______   ______     ______     ______    
/\  ___\   /\  __ \   /\  __ \   /\ \       /\  ___\   /\__  _\ /\  __ \   /\  == \   /\  ___\   
\ \ \____  \ \ \/\ \  \ \ \/\ \  \ \ \____  \ \___  \  \/_/\ \/ \ \ \/\ \  \ \  __<   \ \  __\   
 \ \_____\  \ \_____\  \ \_____\  \ \_____\  \/\_____\    \ \_\  \ \_____\  \ \_\ \_\  \ \_____\ 
  \/_____/   \/_____/   \/_____/   \/_____/   \/_____/     \/_/   \/_____/   \/_/ /_/   \/_____/ 

CoolStore Website is a containerised microservices application consisting of services based on .NET Core, NodeJS and more running on Service Mesh. It demonstrates how to wire up small microservices into a larger application using microservice architectural principals. Read documentation for more information.

The business domain is inspired from CoolStore project by JBoss Demo Central and Red Hat Demo Central.

Check out my blog or say hi on Twitter!

Try it online

Open in Gitpod

Usage with careful: The project is in development mode so that a lot of things shall change due to .NET Core 3.x upgrading.

Public presentation

Table of contents

Screenshots

Home page

home-page

Shopping Cart page

cart-page

Business Context

Conceptual Model

conceptual-model

Event Storming

es-bc

Context Map

es-context-map

OS, SDK, library, tooling and prerequisites

Infrastructure

  • Windows 10 - the OS for developing and building this demo application.
  • Windows subsystem Linux - Ubuntu OS - the subsystem that helps to run easily the bash shell on Windows OS.
  • Docker for desktop (Kubernetes enabled) - the easiest tool to run Docker, Docker Swarm and Kubernetes on Mac and Windows.
  • Kubernetes / AKS - the app is designed to run on Kubernetes (both locally on “Docker for Desktop”, as well as on the cloud with AKS).
  • helm - the best package manager to find, share, and use software built for Kubernetes.
  • istio - application works on Istio service mesh.
  • linkerd2 - a service mesh for Kubernetes and beyond.

Back-end

  • .NET Core 3.x - .NET Framework and .NET Core, including ASP.NET and ASP.NET Core.
  • IdentityServer4 - the Identity and Access Control solution for .NET Core.
  • gRPC - a high-performance, open-source universal RPC framework.
  • Redis - General purpose redis client.
  • NEST - Elasticsearch.Net & NEST.

Front-end

  • nodejs 10.x - JavaScript runtime built on Chrome’s V8 JavaScript engine.
  • typescript - a typed superset of JavaScript that compiles to plain JavaScript.
  • create-react-app - a modern web app by running one command.

High level software architecture

Architecture Screenshot

There are several individual µservices and infrastructure components that make up this app:

Installation

Development environment

Up and running with Docker and docker compose

$ docker-compose -f docker-compose.yml -f docker-compose.dev.yml build
$ docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d

See https://vietnam-devs.github.io/coolstore-microservices/development/#up-and-running-with-docker-and-docker-compose

Staging and Production environments

Up and Running on Azure Kubernetes Service (AKS)

See https://vietnam-devs.github.io/coolstore-microservices/development/#up-and-running-manually-on-docker-for-desktop-and-aks

µService development

Guidance for developing µService can be found at Clean Domain-Driven Design in 10 minutes

µService Screenshot

Open API

OpenAPI Screenshot

https://documenter.getpostman.com/view/4847807/SVmvUeZv?version=latest#9f5ed7e4-e855-46e5-a42d-64edb31bc1cb

CI/CD

Lift and Shift

Service mesh

istio provide a wealth of benefits for the organizations that use them. There’s no denying, however, that adopting the cloud can put strains on DevOps teams. Developers must use microservices to architect for portability, meanwhile operators are managing extremely large hybrid and multi-cloud deployments. Istio lets you connect, secure, control, and observe services.

Distributed tracing

DAG chart

Trace chart

Metrics

Metrics chart

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :p

Contributors ✨

Thanks goes to these wonderful people (emoji key)

Licence

Code released under the MIT license.

comments powered by Disqus