Deploy a local kind cluster

This guide will help you throught the process of deploying a local kind cluster.

Kind is a tool for running local Kubernetes clusters using Docker container “nodes”. Kind was primarily designed for testing Kubernetes itself, but may be used for local development or CI.

Prerequisites

This guide assumes you have alreay installed:

• Docker
• kubectl
• kind

Create a cluster

Create a kind config file called kind-config.yaml with the following content:

kind: Cluster apiVersion: kind.x-k8s.io/v1alpha4 nodes: - role: control-plane kubeadmConfigPatches: - | kind: InitConfiguration nodeRegistration: kubeletExtraArgs: node-labels: "ingress-ready=true" extraPortMappings: - containerPort: 80 hostPort: 80 protocol: TCP - containerPort: 443 hostPort: 443 protocol: TCP 

Then create the cluster using the following command:

kind create cluster --config kind-config.yaml 

The configured cluster is ready to accept requests on port 80 and 443.

Install ingress controller

By default k8s does not have an ingress controller installed. To install the ingress controller run the following command:

kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/master/deploy/static/provider/kind/deploy.yaml 

This will install the nginx ingress controller in the cluster (the most used ingress controller right now, but you can install many other, the only thing you have to do is to change the ingressClassName in your ingress resources).

Test the cluster

To test the cluster you can create a simple deployment and a service:

kubectl run hello \ --expose \ --image nginxdemos/hello:plain-text \ --port 80 

Then create a file called ingress.yaml with the following content:

apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: hello spec: rules: - host: hello.robertoconterosito.it http: paths: - pathType: ImplementationSpecific backend: service: name: hello port: number: 80 

Then apply the ingress resource:

kubectl apply -f ingress.yaml 

Now you can test the ingress resource using the following command:

curl -H "Host: hello.robertoconterosito.it" localhost