Cool Store: Cloud-Native Microservices Application on Service Mesh

This project is inspired from CoolStore project by JBoss Demo Central & Red Hat Demo Central

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.

Screenshots

Home Page	Product Page

Presentation

Our team uses this application to demonstrate Kubernetes, AKS, Istio and similar cloud-native technologies in events as following

• From Microservices to Service Mesh - DevCafe Event - July 2018
• Service Mesh for Microservices- Vietnam Mobile Day Event - June 2018

Table of contents

• Prerequisites
• Installation
• µService Development
• Open API
• CI/CD
• Contributing
• Contributors
• Licence

Prerequisites

• Windows 10
• Windows Subsystem Linux (WSL - Ubuntu OS)
• Docker for Desktop (Kubernetes enabled)
• kubectl
• helm
• istioctl

µServices

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

No.	Service	Description	Language	Database	Endpoints
1	Catalog	Serves products and prices for retail products	Node.js	Mongo	http://localhost:5002 or http://api.coolstore.local/catalog
2	Cart	Manages shopping cart for each customer	.NET Core	MySQL	http://localhost:5003 or http://api.coolstore.local/cart
3	Inventory	Serves inventory and availability data for retail products	.NET Core	MySQL	http://localhost:5004 or http://api.coolstore.local/inventory
4	Pricing	Handles a business rules application for product pricing	.NET Core	MySQL	http://localhost:5005 or http://api.coolstore.local/pricing
5	Review	Runs for writing and displaying reviews for products	.NET Core	MySQL	http://localhost:5006 or http://api.coolstore.local/review
6	Rating	Runs for rating products	Node.js	Mongo	http://localhost:5007 or http://api.coolstore.local/rating
7	IdP	Uses IdentityServer4 to authentication with OAuth 2.0 and OpenID Connect for the whole stack	.NET Core	In Memory	http://localhost:5001 or http://id.coolstore.local
8	Web UI (PWA)	Frontend based on vuejs and Node.js	Vuejs + Node.js	N/A	http://localhost:8080 or http://coolstore.local

Architecture of µServices

Features

• 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.
• NetCoreKit: Set of Cloud Native tools and utilities for .NET Core.

Installation

Option 1: Up and Running locally with "Docker for Desktop", development only

1. Make sure we have Docker for Desktop running with Kubernetes option enabled. We need to install kubectl, helm and istioctl on the build machine as well.

2. From current console, type bash to enter Linux Subsystem (Ubuntu)

3. Then cd into your root of project

> ./deploys/cs-build.sh

It should run and package all docker images.

4. Download and install istio-1.0.0 on the box, and unzip it into somewhere, then initialize it with following commands

> cd <istio-1.0.0 path>
> kubectl create -f install/kubernetes/helm/helm-service-account.yaml
> helm init --service-account tiller --upgrade

5. Get istio-ingressgateway IP address

> kubectl get services istio-ingressgateway -n istio-system -o=jsonpath={.spec.clusterIP}
> 10.96.34.68 <== example IP

6. Create values.dev.local.yaml file in deploys/charts/coolstore, and put content like

gateway:
  ip: 10.96.34.68

7. Apply istioctl command to coolstore chart

> helm template deploys/charts/coolstore -f deploys/charts/coolstore/values.dev.yaml -f deploys/charts/coolstore/values.dev.local.yaml > deploys/k8s/dev-all-in-one.yaml
> istioctl kube-inject -f deploys/k8s/dev-all-in-one.yaml | kubectl apply -f -

8. Add hosts file with following content

127.0.0.1   api.coolstore.local
127.0.0.1   id.coolstore.local
127.0.0.1   coolstore.local

Waiting for the container provision completed

> curl -I http://coolstore.local # website
> curl -I http://api.coolstore.local # api gateway
> curl -I http://id.coolstore.local # identity provider

9. Clean up coolstore chart as

> kubectl delete -f deployment/istio/dev-all-in-one.yaml
> helm delete istio --purge

Notes:

1. Global path

Set PATH for docker, kubectl, helm, and istioctl.

2. Run with Nginx (not recommendation)

If you want to run just only Kubernetes + nginx-ingress go to deploys/charts/coolstore/values.yaml, and modify as following

nginx:
   enabled: true

Then run the helm command as

helm install --name cs-nginx stable/nginx-ingress

Option 2: Up and Running on Azure Kubernetes Service (AKS)

TODO

µService Development

Open API

CI/CD

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

Thang Chung	Thinh Nguyen

Licence

Code released under the MIT license.