ggriffiths / virgo

Run Unikernels Locally and Natively on OSX and Linux

virgo

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 [email protected] 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:

Run command requires root privileges.

sudo virgo run html

# for headless mode use flag
sudo virgo run --headless html

Kill a local Unikernel Project:

Kill command also requires root privileges.

sudo 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

List all local Unikernels:

virgo list

Remove a local Unikernel Project:

sudo 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

If you want to enable HAX (intel hardware acceleration) on Mac you have to options:

You can either roll your own kernel extension or you can download a dmg:

Roll Your Own Extension

1. boot into recovery mode (reboot && cmd-shift-R) and disable system integrity either of the two following methods:

csrutil enable --without kext

csrutil disable

2. git clone https://github.com/intel/haxm

3. build the kernel extension: (note: substitute the 10.13 for whatever is in sw_vers -productVersion)

xcodebuild -config Release -sdk macosx10.13

4. sudo chown -R root:wheel intelhaxm.kext

5. sudo kextutil intelhaxm.kext

Download a signed dmg

https://software.intel.com/en-us/android/articles/installation-instructions-for-intel-hardware-accelerated-execution-manager-mac-os-x

6. You should now be able to see that hax is working: qemu-system-x86_64 -accel hax