Local cluster with minikube

Warning

This guide hasn’t been tested yet, please report back any issues

If you want to play with the Jumpstarter Controller on your local machine, we recommend running a local Kubernetes cluster on your development machine.

Warning

We do not recommend a local cluster for a production environment such as a lab. Please use a full Kubernetes installation either on-prem or in the cloud.

miniKube is a tool for running local Kubernetes clusters using VMs or container nodes, it works across several platforms and can be used with different hypervisors.

You can find more information on the minikube website.

Installation

Start a minikube cluster

minikube start

Get the minikube cluster IP

export IP=$(minikube ip)

Install Jumpstarter

export BASEDOMAIN="jumpstarter.${IP}.nip.io"
export GRPC_ENDPOINT="grpc.${BASEDOMAIN}:8082"
export GRPC_ROUTER_ENDPOINT="router.${BASEDOMAIN}:8083"

helm upgrade jumpstarter --install oci://quay.io/jumpstarter-dev/helm/jumpstarter \
            --create-namespace --namespace jumpstarter-lab \
            --set global.baseDomain=${BASEDOMAIN} \
            --set jumpstarter-controller.grpc.endpoint=${GRPC_ENDPOINT} \
            --set jumpstarter-controller.grpc.routerEndpoint=${GRPC_ROUTER_ENDPOINT} \
            --set global.metrics.enabled=false \
            --set jumpstarter-controller.grpc.nodeport.enabled=true \
            --set jumpstarter-controller.grpc.mode=nodeport \
            --version=0.5.0