Menu
Use when you need to understand how the OKD nodes (VMs) are created, managed, and destroyed on the desktop-server libvirt host in the homelab.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when you need to understand the physical servers, their operating systems, or hardware specifications in the homelab.
Use when setting up or managing Entra ID (Azure AD) OAuth authentication for an OKD/OpenShift cluster. This skill covers the creation of Azure App Registrations, cluster secrets, and the OAuth configuration resource.
Use when you need to understand or configure the DNS setup for the homelab and the OKD cluster, including Pi-hole records.
Use when you need to understand the homelab's network topology, IP ranges, gateway, or DNS server locations.
Use when managing or troubleshooting the Nginx-based load balancer (okd-lb) for the OKD cluster.
High-level overview of the OKD cluster setup process. Use this to understand the end-to-end flow from planning IPs and DNS to starting the VMs.
| name | openshift-node-setup |
| description | Use when you need to understand how the OKD nodes (VMs) are created, managed, and destroyed on the desktop-server libvirt host in the homelab. |
This skill describes how the 3-node OKD cluster is provisioned and managed on the desktop-server libvirt host in the homelab.
The installation uses the OpenShift Agent-Based Installer, meaning there is no separate bootstrap VM. Instead, master-0 acts as the rendezvous host and coordinates the installation.
The cluster consists of 3 Master VMs running on the desktop-server libvirt host.
52:54:00:00:00:1052:54:00:00:00:1152:54:00:00:00:12Networking: VMs use macvtap bridged networking (direct mode), attached to the physical interface of the 192.168.1.0/24 network on the desktop-server host.
Nodes are managed using Ansible playbooks wrapped by the okd/makefile.
All 3 nodes boot from a single generated Agent ISO (agent.x86_64.iso).
make buildmake copy-iso
ansible/copy-iso.yml playbook to push the ISO to the server.make delete-isomake create-vms
ansible/create-vms.yml.desktop-server using virt-install.make start-vmsmake reboot-non-bootstrapmake watch-bootstrapmake watch-master-1, make watch-master-2make watch-allmake wait-installmake destroy-vms
ansible/destroy-vms.yml.virsh destroy), undefines (virsh undefine), and deletes the qcow2 disk images for all 3 master nodes on the desktop-server host.make watch-bootstrap fails with SSH key errors after a rebuild, run make clean-known-hosts to clear the IPs from ~/.ssh/known_hosts.