Skip to main content

First SNO Deploy

Use the SNO path when the target is a true single-node OpenShift lab on one local libvirt host.

Before You Start

Read Prerequisites first. The SNO workflow assumes these local inputs already exist:

InputPath
Active inventoryinventory/hosts.yml
Pull secretsecrets/pull-secret.txt
SSH private keysecrets/id_ed25519
SSH public keysecrets/id_ed25519.pub
Cluster varsvars/cluster/openshift_install_cluster.yml
VM varsvars/guests/openshift_cluster_vm.yml

The SNO DNS records must point api, api-int, and *.apps at the single control-plane node IP.

Prepare Variables

Copy the SNO examples, then edit the active files for the local network and storage plan:

cp vars/cluster/openshift_install_cluster.yml.example vars/cluster/openshift_install_cluster.yml
cp vars/guests/openshift_cluster_vm.yml.example vars/guests/openshift_cluster_vm.yml

Keep platform_type: none for this path.

Deploy

Run the SNO site playbook:

ansible-playbook -i inventory/hosts.yml playbooks/site-openshift-sno.yml --ask-vault-pass --ask-become-pass

For a clean rebuild, use:

ansible-playbook -i inventory/hosts.yml playbooks/site-openshift-sno-redeploy.yml --ask-vault-pass --ask-become-pass

Verify

After completion, run the host policy and VM checks that match your path:

./scripts/host-resource-management.sh shared-execution-pool-status
sudo virsh list --all

For the full phase order, inputs, cleanup, and live checks, see SNO OpenShift Cluster Scaffold.