https://github.com/nocalhost/bookinfo

https://github.com/nocalhost/bookinfo

Last synced: 3 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/nocalhost/bookinfo
• Owner: nocalhost
• Created: 2020-11-05T05:31:13.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2021-11-29T10:45:44.000Z (about 3 years ago)
• Last Synced: 2024-11-22T05:20:28.888Z (2 months ago)
• Language: Mustache
• Size: 198 KB
• Stars: 12
• Watchers: 6
• Forks: 17
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Develop bookinfo with nocalhost

This is a demo project for nocalhost. Bookinfo is from Istio samples(https://github.com/istio/istio/tree/master/samples/bookinfo). 

# Micro Services

Bookinfo is a typical microservice architecture application, which consists of 5 services:

- productpage(Request Entrance): https://github.com/nocalhost/bookinfo-productpage

- reviews: https://github.com/nocalhost/bookinfo-reviews

- details: https://github.com/nocalhost/bookinfo-details

- ratings: https://github.com/nocalhost/bookinfo-ratings

- authors: https://github.com/nocalhost/bookinfo-authors

Every service has its different program language and runtime environment. All of them had been configured to use docker as container runtime, you can find Dockerfile in their corresponding repository.

# Helm 

A helm chart in this repository is prepared for one command installing. 5 Deployments witch 2 replica pods for 5 microservices are main skeleton of this chart.

You can install the chart by this command: `helm install ./charts/bookinfo`, but if you want to try nocalhost, we recommend you do this with nocalhost. We will give step-by-step QuickStart later.

# What we changed compared to istio bookinfo?

We commit some changes to demonstrate nocalhost better. Here are some main changes:

- Simplified different version of reviews service to one version. Nocalhost does not target on how to manage service traffic or canary deployment.

- Splitted source codes from mono-repo to five independent repositories. In reality, diffrent microservices are developed by diffrent teams with different access rules.

- Changed the framework of reviews service to spring-boot. Nothing but everyone loves spring-boot.

- Configured GitHub Action for every microservice to auto build Docker images.

- Added a .nocalhost directory to support development with nocalhost.

# About `.nocalhost` directory

`.nocalhost` is a directory in the root of repository which stores the configurations of nocalhost. In this case, the file `config.yaml`: https://github.com/nocalhost/bookinfo/blob/main/.nocalhost/config.yaml

# How to start?

https://nocalhost.dev/docs/quick-start/

# Contribute

https://github.com/nocalhost/nocalhost/blob/main/CONTRIBUTING.md