A cross-platform framework for instant lab provisioning and reliable user scenario verification.
Yuruna asserts resources are configured to verify components against anticipated workloads. Designed to bridge the gap between fragile prototypes and hardened enterprise deployments, Yuruna automates the complex infrastructure required for deterministic testing. It enables organizations to rapidly provision isolated host environments across diverse architectures, instantly solving the bottlenecks of manual setup and dependency management. With a clean baseline established, teams can continuously execute automated workflows to guarantee that high-stakes user scenarios perform reliably under actual operational stress.
Three main capabilities: reproducible host/guest VM setups for development workspaces, Kubernetes deployment across multiple clouds, and a VM-based test harness. Architecture and conventions: Yuruna Architecture.
Read the online drafts of chapters 0 and 1 of an upcoming book about the Yuruna framework.
See the Administrator Risk Warning in the Yuruna License.
1 -- Install the prerequisites. Paste the one-liner for your OS from
the install scripts, or run the
matching install/ script yourself. It installs dependencies, clones
the framework to ~/git/yuruna (%USERPROFILE%\git\yuruna on
Windows), and seeds test/test.config.yml. Reboot if it says RESTART
REQUIRED, then run the rest from the yuruna folder.
2 -- Configure the host.
pwsh install/setup.ps1
One guided command (details): it
turns off sleep and screen lock, sets up storage, builds the
caching-proxy-service and stash service VMs, and ends on the Test-Config
validation gate. On Windows it relaunches itself elevated once.
3 -- Run your first test.
pwsh test/Start-TestRunner.ps1
Watch progress at http://localhost:8080/status/. Each cycle re-clones
the sample project (repositories.projectUrl in the config) and runs
the
website example
sequences.
Language selection and translation: Languages and localization. Portuguese (Brazil): translated documents.
More info. Operator guide -- the full single-machine runbook, including the dedicated test user; lab operator guide -- several machines as one lab.
- macOS UTM host
- guests: Amazon Linux 2023 - macOS 26 - Ubuntu Server 24.04 - Ubuntu Server 26.04 - Windows 11
- Windows Hyper-V host
- guests: Amazon Linux 2023 - Ubuntu Server 24.04 - Ubuntu Server 26.04 - Windows 11
- Ubuntu KVM/libvirt host
- guests: Amazon Linux 2023 - Ubuntu Server 24.04 - Ubuntu Server 26.04 - Windows 11
After the guest OS is up, test workloads:
- All documentation -- what every doc under
docs/covers - Software bill of materials -- repository, host, and guest inventories
- Requirements - Workarounds & FAQ - Roadmap
- Machine operator and lab operator guides
- Failed-cycle email alerts -- configure Grafana to email once per observed failed test cycle
- Contributing - Contributors - Opportunities
- Changelog - Security policy - License
Cost warning: Cloud resources incur charges. Always clean up Yuruna Resources ... you're not using.
LICENSEURI https://yuruna.link/license
Copyright (c) 2019-2026 by Alisson Sol et al.
Last review: 2026.10.04