Awesome Open Source
Awesome Open Source

Cool Store - Kubernetes-based polyglot microservices application with Istio service mesh

Travis (.org) Build Status Price OpenTracing Badge

CoolStore is a containerised polyglot 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 for more information about how can we design and implement it.

The business domain for internal µservice is inspired from CoolStore project by JBoss Demo Central and Red Hat Demo Central. The readme file is inspired from GoogleCloudPlatform Demo.

Public presentation

Check out my blog, my chat or say hi on Twitter!

Become a sponsor on Patreon


Home page


Cart page


Table of contents

OS, SDK, library, tooling and prerequisites

  • 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)
  • istio - application works on Istio service mesh
  • helm - the best package manager to find, share, and use software built for Kubernetes
  • envoy-proxy - open source edge and service proxy, designed for cloud-native applications
  • .NET Core SDK 2.x - .NET Framework and .NET Core, including ASP.NET and ASP.NET Core
  • nodejs 10.x - JavaScript runtime built on Chrome's V8 JavaScript engine
  • typescript - a typed superset of JavaScript that compiles to plain JavaScript
  • identityserver - the Identity and Access Control solution for .NET Core
  • gRPC - a high-performance, open-source universal RPC framework
  • create-react-app - a modern web app by running one command
  • vue-cli - standard tooling for Vue.js development
  • apollo-client - the best way to use GraphQL to build client applications
  • tanka-graphql - GraphQL execution library with SignalR based server and ApolloLink implementation
  • netcorekit - a crafted microservices toolkit for building cloud-native apps on the .NET platform

High level software architecture

Architecture Screenshot

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

No. Service Description Source Endpoints
1. IdP (.NET Core + In-memory database)
Uses IdentityServer4 to authentication with OAuth 2.0 and OpenID Connect for the whole stack code dev and staging
2. GraphQL server (.NET Core)
The GraphQL server for backoffice application code dev and staging
3. OpenApi (.NET Core + envoy-proxy)
The OpenAPI which generated from gRPC contract files, hosted in OpenAPI format, and used envoy-proxy to proxy it code dev and staging
4. Web (PWA - Vuejs + Node.js)
Frontend based on vuejs and Node.js code dev and staging
5. Backoffice (React + TypeScript + Apollo-client)
The back office application for management business entities in the system code dev and staging
6. Catalog (Node.js + TypeScript + Mongo)
Serves products and prices for retail products code dev
7. Cart (.NET Core + MySQL)
Manages shopping cart for each customer code dev
8. Inventory (.NET Core + MySQL)
Serves inventory and availability data for retail products code dev
9. Rating (Node.js + TypeScript + Mongo)
Runs for rating products code dev


Development environment

Up and running manually with Docker for desktop


Up and running with docker compose

$ docker-compose build
$ docker-compose up

Staging and Production environments

Up and Running on Azure Kubernetes Service (AKS)


µService development

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

µService Screenshot

Open API

OpenAPI Screenshot


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 chart


  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)

Thang Chung

💻 💬 📖 👀 🚇 🚧

Phuong Le

💻 📦 🚇

Phi Huynh

🤔 🚇

Thinh Nguyen

💻 🚧

Stuart Leeks



Code released under the MIT license.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
C Sharp (276,133
Typescript (246,428
Reactjs (70,630
Docker (33,286
Kubernetes (11,174
Rest Api (7,976
Postgresql (7,432
Redis (6,659
Microservice (5,844
Dotnet Core (4,295
Grpc (2,222
Clean Architecture (1,688
Ddd (1,069
Cloud Native (790
Microservices Architecture (435
Service Mesh (333
Aks (225
Related Projects