This repo contains a number of utility scripts to setup a virtualized OKD cluster using agent-based installer (ABI). The main goal is to provide a quick and easy playground for deploying OKD and experiment the various features of ABI, by using the simplest approach possible (meant for educational/testing purpouses only).
The current scripts are limited to deploy just the Single Node OpenShift (SNO) topology only (so 1 node cluster).
- Requires libvirt
- virt-manager is recommended
- An ssh key stored in
~/.ssh/id_rsa.pub
- Launch the setup script specifying the required release version (see the release page).
$ ./sno-setup.sh quay.io/openshift/okd:4.15.0-0.okd-2024-01-27-070424
- Wait for the installation to complete. The console will show a detailed output about each phase of the installation.
...
INFO Cluster is installed
INFO Install complete!
INFO To access the cluster as the system:admin user when using 'oc', run
INFO export KUBECONFIG=/tmp/agent/auth/kubeconfig
...
NOTE: The IP of the node is
192.168.133.80
- Connect to your new cluster using the credentials stored in the asset folder.
$ export KUBECONFIG=/tmp/mini-agent/auth/kubeconfig
$ kubectl get nodes
NAME STATUS ROLES AGE VERSION
master-0 Ready control-plane,master,worker 36m v1.28.6+0fb4726
Optionally, verify that the cluster has been correctly deployed:
$ kubectl get clusterversion version
NAME VERSION AVAILABLE PROGRESSING SINCE STATUS
version 4.15.0-0.okd-2024-01-27-070424 True False 51m Cluster version is 4.15.0-0.okd-2024-01-27-070424
- Once done, to remove the cluster and cleanup the enviroment simply run the cleanup script.
$ ./sno-cleanup.sh
To access the node via SSH use the following command.
$ ssh [email protected]
These scripts were inspired thanks to the experience and contributions of the various authors of dev-scripts