Yuruna asserts resources are configured to verify components against anticipated workloads.
Three 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 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/Invoke-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.
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 - Requirements · Workarounds & FAQ · Roadmap
- Machine operator and lab operator guides
- Contributing · Contributors · Opportunities
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.08.07