/virgo

Run Unikernels Locally and Natively on OSX and Linux

Primary LanguageGoMIT LicenseMIT

virgo

wercker status

This is an example of using the DeferPanic Unikernel IaaS API.

Here we make a docker-like application to get and run unikernels locally on your mac.

Quick Start:

  1. Install

  2. virgo signup my@email.com username mypassword

  3. ./virgo pull eyberg/go

Slightly Longer Web Start:

  1. Sign up for a free account at https://deferpanic.com .

  2. Cut/Paste your token in ~/.dprc.

  3. Watch the demo video @ https://youtu.be/P8RUrx4jE5A .

  4. Fork/Compile/Run a unikernel on deferpanic and then run it locally.

##Install:

go get github.com/deferpanic/dpcli/dpcli
go install github.com/deferpanic/dpcli/dpcli
go install

echo "mytoken" > ~/.dprc

##Pull a Unikernel Project:

virgo pull html

##Run a Unikernel Project:

virgo run html

##Kill a local Unikernel Project:

virgo kill html

##Fetch the log for the Unikernel Project:

virgo log html

##List all Unikernels that are Installed:

virgo images

##List the Running Unikernels:

virgo ps

##Remove a local Unikernel Project:

virgo rm html

##Dependencies: This works on OSX and Linux.

For OSX - this has been tested on {El Capitan, Sierra}. For bridge/outgoing connections you'll want to pay attention to this section.

Note: If you are running Sierra you really should upgrade to Go 1.7 - there are multiple issues.

It's known to work on {10.11.4, 10.11.5, 10.11.6, 10.12.

Qemu:

brew install qemu

TunTapOSx:

wget https://downloads.sourceforge.net/tuntaposx/tuntap_20150118.tar.gz