Small, sample K8s deployment of an nginx image on Minikube with Helm.

This is just a POC, but hypothetically you could deploy something useful with it by modifying the ConfigMap object that's used to deploy the files, in minik8s/templates/configmap.yaml. It's currently used to mount files from the minik8s/html/ directory into the nginx container to serve them.

• Minikube
• Docker
• Helm
• kubectl (optional)
• Make (optional)

Also, a minik8s.local host entry is needed in your system's hosts file. E.g. for Linux, it will be /etc/hosts and on Windows it's C:\Windows\System32\drivers\etc\hosts.

If you use Docker Desktop, use 127.0.0.1 as the address. Otherwise, use the IP you get from minikube ip.

You can just run the following to run the full deployment:

make

If you encounter an error failing to call an Ingress validation webhook, that means that the deploy was too fast and the Minikube's Ingress Controller did not load yet. Rerun the deploy Make target after a few seconds, or check the status of the addon by running:

kubectl -n ingress-nginx get pods

The ingress-nginx-controller-* pod should be ready and running.

If you use Docker Desktop, you must also run the Minikube tunnel:

make tunnel

You will then be able to access the site through your web browser at http://minik8s.local/, or use a curl command:

curl -vvvv http://minik8s.local/

All objects are in the minik8s namespace. Delete it to delete all the objects from this repository.

Just run:

make clean

docker build . --tag nginx:minik8s

docker run --rm --name minik8s -p 0.0.0.0:8080:80 nginx:minik8s

And try to access http://localhost:8080/.

Install Minikube from their site.

minikube start

Test the local cluster with kubectl. Minikube installation will modify your default kubectl configuration file. In Linux, this will be ~/.kube/config.

kubectl cluster-info

Load the built image from Docker into Minikube:

minikube image load nginx:minik8s

Enable the ingress addon for Minikube:

minikube addons enable ingress

Deploy the Helm chart for MiniK8s:

helm upgrade --install --namespace minik8s --create-namespace minik8s-release ./minik8s/

You will then be able to access the site through your web browser at http://minik8s.local/, or use a curl command:

curl -vvvv http://minik8s.local/

In a separate terminal, you must start a Minikube Tunnel.

minikube tunnel

Delete the minik8s namespace to delete all other objects:

kubectl delete namespace minik8s