minikube tutorial (for mac osx)

requirements

minikube - brew install $(brew search minikube)
kubectl - brew install kubernetes-cli
jq - brew install jq

general instructions

git clone this tutorial and cd into it
do not change the console tab, because some commands depend on local environment variables.

install xhyve

brew install docker-machine-driver-xhyve - pay attention to instructions at the end of installation! (execute two sudo commands)

check if minikube machine is started

minikube status

delete old virtual minikube if not created with --insecure-registry option

minikube stop ; minikube delete

start minikube virtual machine

minikube start --cpus 4 --memory 4096 --vm-driver=xhyve

ping minikube VM to see if it is live

ping $(minikube ip)

see if kubectl works correctly (repeat command untill all are READY x/x)

kubectl get pods --all-namespaces

install docker registry on minikube

minikube ssh 'docker run -d -p 5000:5000 --name registry registry:2'

setup environment variables

eval $(minikube docker-env)
export KUBECONFIG=$(pwd)/kubeconfig
env | grep -E 'DOCKER|KUBE'

build and push docker image

docker build -t localhost:5000/tutorial/hellonode .
docker push localhost:5000/tutorial/hellonode

create deployment and service

kubectl run hello --image=localhost:5000/tutorial/hellonode --port=8080 # port 8080 is from Dockerfile
kubectl expose deploy hello --port=80 --target-port=8080 --type=NodePort

check dashboard to make sure everything is ok

minikube dashboard

get hellonode node port (load balancer services are not supported in minikube)

kubectl get services -o wide
HELLO_PORT=$(kubectl get service/hello -o json | jq '.spec.ports[0].nodePort')

open service in your browser

open http://$(minikube ip):$HELLO_PORT