Setup dev environment by kind
This script sets up an OCM developer environment on your local machine with three kind clusters: hub, cluster1, and cluster2. The hub is used as the control plane of the OCM and is also registered as a managed cluster named local-cluster. The other two clusters are registered on the hub as managed clusters.
Prerequisite
kind must be installed on your local machine. The Kubernetes version must be >= 1.19, see kind user guide for more details.
Download and install clusteradm. For Linux OS, run the following commands:
wget -qO- https://github.com/open-cluster-management-io/clusteradm/releases/latest/download/clusteradm_linux_amd64.tar.gz | sudo tar -xvz -C /usr/local/bin/
sudo chmod +x /usr/local/bin/clusteradm
Setup the clusters
Run ./local-up.sh, you will see three clusters registered on the hub cluster.
NAME HUB ACCEPTED MANAGED CLUSTER URLS JOINED AVAILABLE AGE
cluster1 true https://127.0.0.1:45325 True True 116s
cluster2 true https://127.0.0.1:45325 True True 98s
local-cluster true https://127.0.0.1:45325 True True 78s
Known issue when running the setup script on a Linux environment
You may run into this issue when trying to create multiple clusters
Creating cluster "cluster2" ...
✓ Ensuring node image (kindest/node:v1.26.3) 🖼
✗ Preparing nodes 📦
ERROR: failed to create cluster: could not find a log line that matches "Reached target .*Multi-User System.*|detected cgroup v1
This might be caused by kernel limits such as number of open files, inotifiy watches, etc.
To solve this, try increasing your max_user_instances and max_user_watches:
- To see the current limits
$ cat /proc/sys/fs/inotify/max_user_watches $ cat /proc/sys/fs/inotify/max_user_instances - To temporarily increase the limits
$ sudo sysctl fs.inotify.max_user_instances=8192 $ sudo sysctl fs.inotify.max_user_watches=524288 $ sudo sysctl -p - To permanently increase the limits
$ sudo echo "fs.inotify.max_user_watches=1024" >> /etc/sysctl.conf $ sudo echo "fs.inotify.max_user_instances=1024" >> /etc/sysctl.conf $ sudo sysctl -p /etc/sysctl.conf #reloads system settings to apply changes
Once you've increased the limits, delete the clusters already created and try again:
$ kind delete clusters hub cluster1 cluster2
$ ./local-up.sh