docker-machine-driver-xhyve

Travis-CI	CircleCI

Docker Machine driver plugin for xhyve native OS X Hypervisor

Master branch inherited from nathanleclaire/docker-machine-driver-xhyve. Thanks @nathanleclaire :)
If you have issues or pull-requests, Desired to be posted to this repository.

Screencast

Required

Other than Mac OS X 10.11.4 build (15E27e)

Mac OS X 10.11.4 (15E27e) has a Hypervisor.framework bug.
This is Apple's bug.
but, Apple has been fixed build 15E33e. Please upgrade latest beta.
See

• https://asciinema.org/a/34798 (15E27e)
• https://asciinema.org/a/34797 (15E33e)

If you launch the docker-machine-driver-xhyve on build 15E27e, will displayed

open : no such file or directory

on "Convert UUID to MAC address...".
and, In original xhyve,

hv_vm_create failed

docker-machine

https://github.com/docker/machine

docker-machine-driver-xhyve using docker-machine plugin model.

Please do not post the issue of this repository to the docker/machine
It will interfere with the development of the docker-machine.
If you were doubt problem either, please post to this repository issues.

> go get github.com/docker/machine
> cd $GOPATH/src/github.com/docker/machine
# Build docker-machine binary
> make build
# Install docker-machine binary into /usr/local/bin/
> make install

Install

Use Homebrew/homebrew,

$ brew install docker-machine-driver-xhyve

# docker-machine-driver-xhyve need root owner and uid
$ sudo chown root:wheel $(brew --prefix)/opt/docker-machine-driver-xhyve/bin/docker-machine-driver-xhyve
$ sudo chmod u+s $(brew --prefix)/opt/docker-machine-driver-xhyve/bin/docker-machine-driver-xhyve

Use go get,

# Need Go 1.5 vendoring support
$ export GO15VENDOREXPERIMENT=1

$ go get -u github.com/zchee/docker-machine-driver-xhyve

# docker-machine-driver-xhyve need root owner and uid
$ sudo chown root:wheel $GOPATH/bin/docker-machine-driver-xhyve
$ sudo chmod u+s $GOPATH/bin/docker-machine-driver-xhyve

Usage

Available flags

Flag name	Environment variable	Type	Description	Default
--xhyve-boot2docker-url	XHYVE_BOOT2DOCKER_URL	string	The URL(Path) of the boot2docker image	$HOME/.docker/machine/cache/boot2docker.iso
--xhyve-cpu-count	XHYVE_CPU_COUNT	int	Number of CPUs to use the create the VM	1
--xhyve-memory-size	XHYVE_MEMORY_SIZE	int	Size of memory for the guest	1024
--xhyve-disk-size	XHYVE_DISK_SIZE	int	Size of disk for the guest (MB)	20000
--xhyve-boot-cmd	XHYVE_BOOT_CMD	string	Booting xhyve iPXE commands	See boot2docker/boot2docker/doc/AUTOMATED_SCRIPT.md
--xhyve-virtio-9p	XHYVE_VIRTIO_9P	bool	Enable virtio-9p folder share	false
--xhyve-experimental-nfs-share	XHYVE_EXPERIMENTAL_NFS_SHARE	bool	Enable NFS folder share (experimental)	false

virtio-9p support is included in boot2docker as of version 1.10.2. For earlier releases you need a custom boot2docker.iso See https://github.com/zchee/boot2docker-legacy/releases.

Would you do me a favor?

I'm very anxious whether other users(except me) are able to launch the xhyve.
So, if you were able to launch the xhyve use docker-machine-driver-xhyve, Would you post a report to this issue thread? machine-drivers#18

If OS X launched by the Vagrant, can be build, but will not be able to launch the Hypervisor.
The cause probably because backend vm (Virtualbox, VMWare, parallels...) to hide the CPU infomation.

In the case of VMWare,

$ system_profiler SPHardwareDataType
2015-11-21 10:04:18.972 system_profiler[458:1817] platformPluginDictionary: Can't get X86PlatformPlugin, return value 0
2015-11-21 10:04:18.974 system_profiler[458:1817] platformPluginDictionary: Can't get X86PlatformPlugin, return value 0
Hardware:

    Hardware Overview:

      Model Name: Mac
      Model Identifier: VMware7,1
      // Where is "Processor Name:" field?
      Processor Speed: 2.19 GHz
      Number of Processors: 1
      Total Number of Cores: 1
      L2 Cache: 256 KB
      L3 Cache: 6 MB
      Memory: 2 GB
      Boot ROM Version: VMW71.00V.0.B64.1505060256
      SMC Version (system): 1.16f8
      Serial Number (system): ************
      Hardware UUID: ********-****-****-****-************

> git clone https://github.com/mist64/xhyve && cd xhyve
> make
> ./xhyverun.sh
vmx_init: processor not supported by Hypervisor.framework
Unable to create VM (-85377018)

Known isuue

Experimental shared folders

docker-machine-driver-xhyve can create a NFS share automatically for you, but this feature is highly experimental. To use it specify --xhyve-experimental-nfs-share when creating your machine.

Does not clean up the vmnet when remove a VM

Current state, docker-machine-driver-xhyve does not clean up the vmnet configuration.

Running xhyve vm (e.g. IP: 192.168.64.1)
        |
`docker-machine rm`, ACPI signal(poweroff) in over ssh
        |
vm is poweroff, `goxhyve` also killed with to poweroff
        |
Re-create xhyve vm.

New vm's ip, It will probably be assigned to 192.168.64.2. If create another new vm, assigned to 192.168.64.3
but 192.168.64.1 are not using anyone.

vmnet.framework seems to have decided to IP based on /var/db/dhcpd_leases and /Library/Preferences/SystemConfiguration/com.apple.vmnet.plist
So, To remove it manually, or Don’t even bother.
Maybe vmnet.framework shared net address range 192.168.64.1 ~ 192.168.64.255. You can make 255 vm.

I will fix after I understand the vmnet.framework