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

Minikube installation instructions added

Browse source 
Tested with Minikube+KVM (4 CPU; 4GB RAM).

Signed-off-by: Ihor Dvoretskyi <ihor@linux.com>
This commit is contained in:
Ihor Dvoretskyi 2019-04-23 13:59:04 +00:00
parent f2f382f6bb
commit 346a4cacb8
1 changed files with 29 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

38
README.md
View file

@ -68,11 +68,16 @@ Find **Protocol Buffers Descriptions** at the [`./pb` directory](./pb).
## Installation ## Installation
We offer three installation methods: We offer the following installation methods:
1. **Running locally with “Docker for Desktop”** (~20 minutes) You will build 1. **Running locally** (~20 minutes) You will build
and deploy microservices images to a single-node Kubernetes cluster running and deploy microservices images to a single-node Kubernetes cluster running
on your development machine. on your development machine. There are two options to run a Kubernetes
cluster locally for this demo:
- [Minikube](https://github.com/kubernetes/minikube). Recommended for the
Linux hosts (also supports Mac/Windows).
- [Docker for Desktop](https://www.docker.com/products/docker-desktop).
Recommended for Mac/Windows.
2. **Running on Google Kubernetes Engine (GKE)”** (~30 minutes) You will build, 2. **Running on Google Kubernetes Engine (GKE)”** (~30 minutes) You will build,
upload and deploy the container images to a Kubernetes cluster on Google upload and deploy the container images to a Kubernetes cluster on Google
@ -83,7 +88,7 @@ We offer three installation methods:
option, you will use pre-built container images that are available publicly, option, you will use pre-built container images that are available publicly,
instead of building them yourself, which takes a long time). instead of building them yourself, which takes a long time).
### Option 1: Running locally with “Docker for Desktop” ### Option 1: Running locally
> 💡 Recommended if you're planning to develop the application or giving it a > 💡 Recommended if you're planning to develop the application or giving it a
> try on your local cluster. > try on your local cluster.
@ -91,16 +96,31 @@ We offer three installation methods:
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 - Local Kubernetes cluster deployment tool:
- [Minikube (recommended for
Linux)](https://kubernetes.io/docs/setup/minikube/).
- Docker for Desktop (recommended for Mac/Windows): It provides Kubernetes support as [noted
here](https://docs.docker.com/docker-for-mac/kubernetes/). here](https://docs.docker.com/docker-for-mac/kubernetes/).
- [skaffold](https://skaffold.dev/docs/getting-started/#installing-skaffold) - [skaffold](https://skaffold.dev/docs/getting-started/#installing-skaffold)
(ensure version ≥v0.20) (ensure version ≥v0.20)
1. Launch “Docker for Desktop”. Go to Preferences: 1. Launch the local Kubernetes cluster with one of the following tools:
- choose “Enable Kubernetes”, - Launch Minikube (tested with Ubuntu Linux). Please, ensure that the
- set CPUs to at least 3, and Memory to at least 6.0 GiB local Kubernetes cluster has at least:
- on the "Disk" tab, set at least 32 GB disk space - 4 CPU's
- 4GB RAM
To run a Kubernetes cluster with Minikube using the described configuration, please run:
```shell
minikube start --cpus=4 --memory 4096
```
- Launch “Docker for Desktop” (tested with Mac/Windows). Go to Preferences:
- choose “Enable Kubernetes”,
- set CPUs to at least 3, and Memory to at least 6.0 GiB
- on the "Disk" tab, set at least 32 GB disk space
1. Run `kubectl get nodes` to verify you're connected to “Kubernetes on Docker”. 1. Run `kubectl get nodes` to verify you're connected to “Kubernetes on Docker”.