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

• tmux
• qemu (>=2.4, including kvm support)
• linux
• builder (compiled and included in $PATH)

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 /etc/qemu/bridge.conf.

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.

• Mailing list: giantswarm
• IRC: #giantswarm on freenode.org
• Bugs: issues

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.

onsho (おんしょう[温床] pronounced "on-shou") is Japanese for breeding ground.