docs/daprdocs/content/en/operations/hosting/kubernetes/cluster/setup-kind.md

type	title	linkTitle	weight	description
docs	Set up a KiND cluster	KiND	1100	How to set up a KiND cluster

Prerequisites

• Install:
  • Docker
  • kubectl
• For Windows:
  • Enable Virtualization in BIOS
  • Install Hyper-V

Install and configure KiND

Refer to the KiND documentation to install.

If you are using Docker Desktop, verify that you have the recommended settings.

Configure and create the KiND cluster

1. Create a file named kind-cluster-config.yaml, and paste the following:

   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: 8081
       protocol: TCP
     - containerPort: 443
       hostPort: 8443
       protocol: TCP
   - role: worker
   - role: worker
   

   This cluster configuration:

   • Requests KiND to spin up a Kubernetes cluster comprised of a control plane and two worker nodes.
   • Allows for future setup of ingresses.
   • Exposes container ports to the host machine.

2. Run the kind create cluster command, providing the cluster configuration file:

   kind create cluster --config kind-cluster-config.yaml
   

   Expected output

   Creating cluster "kind" ...
    ✓ Ensuring node image (kindest/node:v1.21.1) 🖼
    ✓ Preparing nodes 📦 📦 📦
    ✓ Writing configuration 📜
    ✓ Starting control-plane 🕹️
    ✓ Installing CNI 🔌
    ✓ Installing StorageClass 💾
    ✓ Joining worker nodes 🚜
   Set kubectl context to "kind-kind"
   You can now use your cluster with:
   
   kubectl cluster-info --context kind-kind
   
   Thanks for using kind! 😊
   

Initialize and run Dapr

1. Initialize Dapr in Kubernetes.

   dapr init --kubernetes
   

   Once Dapr finishes initializing, you can use its core components on the cluster.

2. Verify the status of the Dapr components:

   dapr status -k
   

   Expected output

     NAME                   NAMESPACE    HEALTHY  STATUS   REPLICAS  VERSION  AGE  CREATED
     dapr-sentry            dapr-system  True     Running  1         1.5.1    53s  2021-12-10 09:27.17
     dapr-operator          dapr-system  True     Running  1         1.5.1    53s  2021-12-10 09:27.17
     dapr-sidecar-injector  dapr-system  True     Running  1         1.5.1    53s  2021-12-10 09:27.17
     dapr-dashboard         dapr-system  True     Running  1         0.9.0    53s  2021-12-10 09:27.17
     dapr-placement-server  dapr-system  True     Running  1         1.5.1    52s  2021-12-10 09:27.18
   

3. Forward a port to Dapr dashboard:

   dapr dashboard -k -p 9999
   

4. Navigate to http://localhost:9999 to validate a successful setup.

Install metrics-server on the Kind Kubernetes Cluster

1. Get metrics-server manifests

   wget https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml
   

2. Add insecure TLS parameter to the components.yaml file

   metadata:
      labels:
        k8s-app: metrics-server
    spec:
      containers:
      - args:
        - --cert-dir=/tmp
        - --secure-port=4443
        - --kubelet-preferred-address-types=InternalIP,ExternalIP,Hostname
        - --kubelet-use-node-status-port
        - --kubelet-insecure-tls   <==== Add this
        - --metric-resolution=15s
        image: k8s.gcr.io/metrics-server/metrics-server:v0.6.2
        imagePullPolicy: IfNotPresent
        livenessProbe:
          failureThreshold: 3
          httpGet:
            path: /livez
   

3. Apply modified manifest

   kubectl apply -f components.yaml
   

Related links

• [Try out a Dapr quickstart]({{< ref quickstarts.md >}})
• Learn how to [deploy Dapr on your cluster]({{< ref kubernetes-deploy.md >}})
• [Upgrade Dapr on Kubernetes]({{< ref kubernetes-upgrade.md >}})
• [Kubernetes production guidelines]({{< ref kubernetes-production.md >}})