This document outlines the steps to run Kubernetes locally, including required installations like Java 8, Maven, Git, Kubernetes CLI (kubectl), Minikube, and Docker. It discusses benefits like cloud-native development and testing applications locally before deploying to cloud providers. The steps covered include starting Minikube, building and pushing a Docker image to Minikube's registry, deploying microservices interactively with kubectl or declaratively with YAML files, exposing services, and testing before stopping Minikube.

1. Author: - GANESH POL, Version 0.1 draft. , 3-Nov-2018
GANESH POL
This document highlight steps required for running K8s on local environment.
Run K8s on Local
Environment

2. Author: - GANESH POL, Version 0.1 draft. , 3-Nov-2018
Benefit of running K8s Locally
1. Facility for cloud native development
2. Facility to run and test application on local before deploying on cloud:- All Major Cloud
providers provide support for K8s e.g. AWS,GCP, Azure, IBM Blue mix…... Running on local
environment provide facility to run and test application locally.
Required installations
Java8 Maven Git
KubeCtl Minikube docker
Hyper-v
Important notes
1. Why unix :- although we can deploy minikube on windows machine as well but
docker installation has limitations with few Microsoft windows OS (windows 10
home edition)
2. Why full fledge installation:- we might use Vagrant for this setup as well but I
prefer to use full fledge installation for simplicity.
3. In this case Java required since we are deploying java based micro services in k8s
cluster. We need java8 and maven for build.
4. We will be using spring boot for development of micro services.
5. Git acts as a source control management (SCM) tool.
6. Docker is used for containerization.
7. We are using oracle VM for virtualization. One can use other hypervisors as well.
Hyper v is required for minikube.
8. K8s tools
Kubectl It is command line utility for running and working with k8s cluster
minikube Provide facility to run single node cluster on our local machine
Other tools can be use for similar purpose Kube2Go, Kubeadm
Types of deployments in K8s
Interactive It utilize kubectl for deployment of micro services in k8s
declarative  It utilizes yaml or JSON files (deployment and service)
for deployment in k8s.
 Same commands used for deployment into cloud
providers e.g. Azure
Please note source code for this example is present at URL and branch
k8s-01
Steps
1. Starting minikube and setting minikube’s internal container registry for
docker build push
2. Deployment of micro service :- either interactively with kubectl or by
declaratively by json or YAML.
a. Deploy deployment
b. Expose service.
3. Test micro service
4. Stop k8s cluster and destroy
Starting minikube and setting minikube’s internal container
registry for docker images
1. Start minikube
minikube start
2. Pre check kubectl version
kubectl version --short
3. We will set local docker repo used by k8s
eval $(minikube docker-env)
Unix os :- Ubantu 18.xx
kubectl docker
Java
Maven
Git
Hyper v-oracle
vm
minkube

3. Author: - GANESH POL, Version 0.1 draft. , 3-Nov-2018
4. Build docker image and tag it
docker build -t $USER/ipmon:dev .
5. Check docker images
Deployment of micro service
Important note
We are not directly deploying container images in k8s. We wrap our docker images in
deployment. This in turn create replication controller. Replication controller creates
PODs which create containers.
Interactive deployment with the help of kubectl
Syntax
kubectl run
<deployment-name>
--image=<docker-image>
--port=<container-port-on-which-it –is-running>
--replicas=<number of replicas>
example
kubectl run ipmon-deployment --image=polganesh/ipmon:dev --port=8080 --replicas=3
In above example we are running three containers of polganesh/ipmon:dev
Please note: - in order to maintain simplicity we are concentrating on interactive
deployment for k8s.in later section I will highlight how to deploy declaratively.
Expose service
Syntax
kubectl expose deployment <name of deployment> --type=NodePort
In our case name of deployment is ipmon-deployment hence command for this
kubectl expose deployment ipmon-deployment --type=NodePort
Test micro service
1. Initial checks
Please note pods status initially container creating
Later on it will be in running state
2. Get service url
curl $(minikube service ipmon-deployment --url)
3. Running example
Stop minikube and delete local cluster