vbatts/microservices-demo
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

Merge 8112914a4a into 6d96944158

Browse source
This commit is contained in:
Ihor Dvoretskyi 2018-09-06 22:35:40 +00:00 • committed by GitHub
commit 4ba1cc3f65
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 6 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

15
README.md
View file

@ -41,8 +41,7 @@ Find **Protocol Buffers Descriptions** at the [`./pb` directory](./pb).
## Features ## Features
- **[Kubernetes](https://kubernetes.io)/[GKE](https://cloud.google.com/kubernetes-engine/):** - **[Kubernetes](https://kubernetes.io)/[GKE](https://cloud.google.com/kubernetes-engine/):**
The app is designed to run on Kubernetes (both locally on "Docker for The app is designed to run on Kubernetes (locally on Minikube, as well as on the cloud with GKE).
Desktop", as well as on the cloud with GKE).
- **[gRPC](https://grpc.io):** Microservices use a high volume of gRPC calls to - **[gRPC](https://grpc.io):** Microservices use a high volume of gRPC calls to
communicate to each other. communicate to each other.
- **[Istio](https://istio.io):** Application works on Istio service mesh. - **[Istio](https://istio.io):** Application works on Istio service mesh.
@ -64,20 +63,18 @@ Find **Protocol Buffers Descriptions** at the [`./pb` directory](./pb).
> **Note:** that the first build can take up to 20-30 minutes. Consequent builds > **Note:** that the first build can take up to 20-30 minutes. Consequent builds
> will be faster. > will be faster.
### Option 1: Running locally with “Docker for Desktop” ### Option 1: Running locally with Minikube
> 💡 Recommended if you're planning to develop the application. > 💡 Recommended if you're planning to develop the application.
1. Install tools to run a Kubernetes cluster locally: 1. Install tools to run a Kubernetes cluster locally:
- kubectl (can be installed via `gcloud components install kubectl`) - kubectl (can be installed via `gcloud components install kubectl`)
- Docker for Desktop (Mac/Windows): It provides Kubernetes support as [noted - Minikube (Linux/Mac/Windows). It's the open source, cross-platrorm tool, developed by the Kubernetes community. Installation instructions and documentation can be found [here](https://github.com/kubernetes/minikube).
here](https://docs.docker.com/docker-for-mac/kubernetes/).
- [skaffold](https://github.com/GoogleContainerTools/skaffold/#installation) - [skaffold](https://github.com/GoogleContainerTools/skaffold/#installation)
1. Launch “Docker for Desktop”. Go to Preferences and choose “Enable Kubernetes”. 1. Launch the local Kubernetes cluster with `minikube start` command. More details can be found [here](https://github.com/kubernetes/minikube#quickstart).
1. Run `kubectl get nodes` to verify that the local cluster works properly.
1. Run `kubectl get nodes` to verify you're connected to “Kubernetes on Docker”.
1. Run `skaffold run` (first time will be slow, it can take ~20-30 minutes). 1. Run `skaffold run` (first time will be slow, it can take ~20-30 minutes).
This will build and deploy the application. If you need to rebuild the images This will build and deploy the application. If you need to rebuild the images
@ -91,7 +88,7 @@ Find **Protocol Buffers Descriptions** at the [`./pb` directory](./pb).
> 💡 Recommended for demos and making it available publicly. > 💡 Recommended for demos and making it available publicly.
1. Install tools specified in the previous section (Docker, kubectl, skaffold) 1. Install tools specified in the previous section (kubectl, skaffold)
1. Create a Google Kubernetes Engine cluster and make sure `kubectl` is pointing 1. Create a Google Kubernetes Engine cluster and make sure `kubectl` is pointing
to the cluster. to the cluster.