Minikube Quickstart

You can execute the Getting Started quick start by leveraging minikube.

Minikube Setup

If you are using a Mac, Homebrew is the easiest way to get minikube setup.

#Prep for minikube
brew install hyperkit

#Install minikube
brew install minikube
brew upgrade minikube

#Customize minikube
minikube delete
minikube config set driver hyperkit
minikube config set memory 8128

Installing Ketch

Follow the Getting Started instructions for installation. Start minikube and tunnel minikube on your local machine. After the tunneling, install an Ingress Controller, install the Ketch CLI, and Ketch Controller.

#Start minikube
minikube start

#Tunnel minikube
#Requires a seperate Terminal
minikube tunnel

#Install Nginx
helm upgrade --install ingress-nginx ingress-nginx \
  --repo https://kubernetes.github.io/ingress-nginx \
  --namespace ingress-nginx --create-namespace

#Install Ketch CLI and Ketch Controller
curl -s https://raw.githubusercontent.com/shipa-corp/ketch/main/install.sh | bash
kubectl apply -f https://github.com/jetstack/cert-manager/releases/download/v1.5.3/cert-manager.yaml
kubectl apply -f https://github.com/shipa-corp/ketch/releases/download/v0.6.2/ketch-controller.yaml

Deploying with Ketch

Grab the external-IP address from the minikube tunnel and then create a Ketch Framework and Ketch Deployment. After the deployment, get the address of your app with ketch app list.

#Get External-IP
kubectl get services -n ingress-nginx
#10.109.244.142

#Add Ketch Framework
ketch framework add dev --ingress-service-endpoint 10.109.244.142 --ingress-type nginx

##Can programatically find the external-IP also
#ketch framework add dev --ingress-type nginx --ingress-service-endpoint $(k get svc ingress-nginx-controller  -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

#Deploy App
ketch app deploy bulletinboard -k dev -i docker.io/shipasoftware/bulletinboard:1.0

#Get App Address
ketch app list
#http://bulletinboard.10.109.244.142.shipa.cloud

📘
Clean-up minikube
When you are done, you can stop and delete your minikube instance.
#Clean Up
minikube stop
minikube delete