How theocaudan/ot-cyberrange works
OT Cyber Range is an Ansible-managed Purdue-style lab. An operator runs the deployment playbook, which provisions segmented libvirt networks and VMs, then configures firewall and application roles; the README describes the intended network boundaries and service mix. Configuration is split among network, VM, firewall, and per-role variables, with host secrets kept in Vault. The README documents the capabilities and intended wiring; source excerpts are limited to a PLC placeholder, so implementation-level calls and deployment order beyond that documentation are not verified.
Main entry points: deploy.yml Deployment playbook · tasks/main.yml PLC / OpenPLC · tasks/main.yml Network role · tasks/main.yml VM role
Components 19
Deployment
- Deployment playbook
deploy.yml
Networks and Security
- Network role
roles/network/tasks/main.yml - Firewall role
roles/firewall/tasks/main.yml
VM Provisioning
- VM role
roles/vm/tasks/main.yml
Lab Services
- Bastion / Guacamole
roles/bastion/tasks/main.yml - Wazuh / Suricata
roles/siem/tasks/main.yml - SCADA / Ignition
roles/scada/tasks/main.yml - PLC / OpenPLC
roles/plc/tasks/main.yml - PLC Python worker
roles/plc/files/app/plc-sim.py - Caldera
roles/caldera/tasks/main.yml - AD controller
roles/ad-dc/tasks/main.yml - AD client
roles/ad-client/tasks/main.yml
Configuration
- Network definitions
vars/networks.yml - Firewall policies
vars/firewall-it-dmz.yml - VM definitions
vars/vms.yml - Host secrets
host_vars/bastion/vault.yml
Other components
- Lab operator
- QEMU / libvirt
- Docker
Connections 23
- Lab operator → Deployment playbook: runs
README.md - Deployment playbook → Network role: deploys networks
README.md - Deployment playbook → VM role: deploys VMs
README.md - Deployment playbook → Firewall role: configures roles
- Deployment playbook → Bastion / Guacamole: configures roles
- Deployment playbook → Wazuh / Suricata: configures roles
- Deployment playbook → SCADA / Ignition: configures roles
- Deployment playbook → PLC / OpenPLC: configures roles
- Deployment playbook → Caldera: configures roles
- Deployment playbook → AD controller: configures roles
- Deployment playbook → AD client: configures roles
- Network definitions → Network role: defines networks
README.md - VM definitions → VM role: defines VMs
README.md - Firewall policies → Firewall role: defines rules
README.md - Network role → QEMU / libvirt: creates networks
- VM role → QEMU / libvirt: creates VMs
README.md - Bastion / Guacamole → Docker: deploys service
README.md - Wazuh / Suricata → Docker: deploys services
README.md - SCADA / Ignition → Docker: deploys service
README.md - PLC / OpenPLC → Docker: deploys services
README.md - PLC / OpenPLC → PLC Python worker: includes worker
README.md - Host secrets → Bastion / Guacamole: stores secrets
README.md - AD client → AD controller: joins domain
README.md