Skip to content

cirruslabs/vetu

Repository files navigation

vetu - Virtualization that is Easy To Use

vetu is virtualization toolset to effortlessly run Cloud Hypervisor-backed virtual machines on Linux hosts.

We say effortlessly, because the existing virtualization solutions like the traditional QEMU and the new-wave Firecracker and Cloud Hypervisor provide lots of options and require users to essentially build a tooling on top of them to be able to simply run a basic VM.

Vetu builds on the success of Tart and abstracts all these peculiarities and makes the virtualization as easy as running containers.

Here are just some of the cool features that Vetu inherited from Tart:

  • Ability to easily distribute VM images by integrating with OCI-compatible container registries. Push and pull virtual machines like they are containers.
  • Effortless SSH'ing into VMs (see Usage for an example)
  • Cirrus CLI integration

Installation

Usage

Try running a Vetu VM on your Linux machine with arm64 processor:

vetu clone ghcr.io/cirruslabs/ubuntu:latest ubuntu
vetu run ubuntu

The default username is admin and password is admin. The machine is only reachable from the localhost with the default configuration, and you can connect to it over SSH using the following command:

ssh admin@$(vetu ip ubuntu)

Networking options

Default (NAT)

The default NAT networking is powered by the gVisor's TCP/IP stack and has an advantage of requiring no configuration on the user's end.

The main disadvantage is the reduced speed, because all the routing and processing is also done in the software (in the Vetu process), in addition to the kernel.

However, this choice is still fast enough to run most of the tasks, for example, provisioning a Linux distro and installing the packages.

Bridged

Bridged networking can be enabling by specifying --net-bridged=BRIDGE_INTERFACE_NAME argument to vetu run and has an advantage of being fast, because all the processing and routing is done in the kernel.

The main disadvantage is that this choice requires the system administrator to properly configure the bridge interface, IP forwarding and NAT, DHCP server (if required by the VM) and the packet filter to provide adequate network isolation.

Host

Host networking can be enabled by specifying --net-host argument to vetu run and has the following advantages:

  • it is fast, because all the processing and routing is done in the kernel
  • no DHCP server is required: Vetu will assign the first available /30 subnet from the private IPv4 address space (excluding parts of that address space already used on the host machine)

The main disadvantage is that this choice requires the system administrator to properly configure the IP forwarding and NAT and the packet filter to provide adequate network isolation.

FAQ

VM location on disk

Vetu stores all it's files in ~/.vetu/ directory. Local images that you can run are stored in ~/.vetu/vms/. Remote images are pulled into ~/.vetu/cache/OCIs/.

About

Create, publish and virtualize ephemeral Linux VMs with ease

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages