Manage QEMU VMs that will be provisioned by Mayu. With Onsho you can replicate a Giant Swarm DC on a single machine or VM.
Download the latest release from here: https://github.com/giantswarm/onsho/releases/latest
Clone the latest git repository version from here: https://github.com/giantswarm/onsho.git
How to build
qemu(>=2.4, including kvm support)
- builder (compiled and included in $PATH)
Building the standard way
make && sudo make install
In order to give qemu cluster machines a separate network they can have fun in you have to create a network bridge:
sudo brctl addbr onsho0 sudo ip link set up dev onsho0 sudo ip addr add 10.0.3.251/22 dev onsho0
If you have systemd you can use systemd-networkd to create the bridge and make it remain after a reboot:
sudo cp host-conf/systemd-networkd/* /etc/systemd/network sudo systemctl restart systemd-networkd sudo systemctl enable systemd-networkd
To allow qemu-bridge-helper to manipulate our bridge add
allow onsho0 to
Start a cluster
Start a qemu cluster:
$ onsho create --num-vms=5 --image=ipxe/ipxe.iso # creates a 5 machine cluster $ tmux a -t zoo # attach to the created tmux session
The simplest setup to get some output would be this:
$ onsho create --num-vms=1 --image=ipxe/ipxe.iso --no-tmux
Check more detailed documentation: docs
Check code documentation: godoc
- Adapt Onsho to also work with VirtualBox on MacOS.
Contributing & Reporting Bugs
See CONTRIBUTING for details on submitting patches, the contribution workflow as well as reporting bugs.
Onsho is under the Apache 2.0 license. See the LICENSE file for details.
Origin of the Name
onsho (おんしょう[温床] pronounced "on-shou") is Japanese for breeding ground.