Yuruna

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.

Safestart

It is recommended that you read the online drafts of chapters 0 and 1 of an upcoming book about the Yuruna framework.

Quickstart

See the Administrator Risk Warning in the Yuruna License.

1. Install Yuruna on a host. Paste the one-liner for your OS from install scripts. It installs dependencies and clones the framework to ~/git/yuruna (%USERPROFILE%\git\yuruna on Windows).

2. In a PowerShell window (pwsh), from the yuruna folder, configure and run:

   Copy-Item test/test.config.yml.template test/test.config.yml
   

   Edit test/test.config.yml and test the configuration.

   test/Test-Config.ps1
   

   Fix any error before proceeding.

   pwsh test/Invoke-TestRunner.ps1
   

   The runner clones the sample project repo (yuruna-project, configured via repositories.projectUrl in the file you just copied) into project/ on every cycle and discovers the website example sequences automatically.

3. Watch progress at http://localhost:8080/status/.

Tests may break if a screensaver activates, the machine sleeps, or similar conditions interrupt them. For each host type, there is a script Enable-TestAutomation.ps1 in the corresponding folder, which sets configurations to avoid most interruptions.

Host / guest support

• 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:

• Amazon Linux 2023
• Ubuntu Server 24.04
• Ubuntu Server 26.04
• Windows 11

Read More

• Requirements · FAQ · Roadmap
• Host pools · Hosts · Guests
• 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.07.14