Skip to content

Files

Latest commit

fhazefhaze
Update KIND.md
Jun 30, 2022
1515ac8 · Jun 30, 2022

History

History
105 lines (84 loc) · 2.89 KB

KIND.md

File metadata and controls

105 lines (84 loc) · 2.89 KB

Orb local k8s cluster

Follow those steps to setup a local k8s cluster and deploy Orb.

🧱 Requirements

💡 Note: If you have those installed, please skip to Deploy Orb on Kind.

🐳 Docker Environment (Requirement)

Check if you have a Docker Environment running by executing:

docker version

If you need help to setup a Docker Environment, follow the steps from here.

⚓ Helm 3 (Requirement)

Check if you have Helm 3 installed by executing:

helm version

If you need help to install Helm 3, follow the steps from here.

🚨 Warning: Make sure you have version 3 installed, orb helm charts doesn't officialy support helm 2.

🐋 Kubectl (Requirement)

Check if you have Kubectl cmd installed by executing:

kubectl version --client

If you need help to install Kubectl, follow the steps from here.

🚢 Install Kind (Requirement)

Kind is a tool for running local k8s clusters using docker container as nodes.

If you have go 1.17 or later installed:

go install sigs.k8s.io/kind@v0.14.0

macOS users can also use brew:

brew install kind

🚨 Windows WSL users: WSL is also supported, but for some reason the Orb stack mess up the WSL internal DNS. You can fix that by editing your /etc/wsl.conf and adding the following:

[network]
generateResolvConf = false

Restart WSL by executing the following on CMD:

wsl --shutdown

Open WSL terminal again and remove the symbolic link from /etc/resolv.conf:

sudo unlink /etc/resolv.conf

Create a new /etc/resolv.conf file and add the following:

nameserver 8.8.8.8

save the file and you are done.

🚀 Deploy Orb on Kind

Add kubernetes.docker.internal host as 127.0.0.1 address in your hosts file:

echo "127.0.0.1 kubernetes.docker.internal" | sudo tee -a /etc/hosts

Setup Orb Charts dependencies repositories:

make prepare-helm

💡 Note: You just need to run those steps until here once, even if you delete the cluster afterwards.

Use the following command to create the cluster and deploy Orb:

make kind-create-all

Access the Orb UI by accessing: https://kubernetes.docker.internal/. The following users are created during the mainflux bootstrap:

E-mail Password Role
admin@kind.com pass123456 Admin

Have fun! 🎉 When you are done, you can delete the cluster by running:

make kind-delete-cluster