Docker machine qemu driver
I needed a non-libvirt qemu driver, so this is it.
Its initial use is going to be for running the Rancher OS tests, but maybe you'll find a use for it too.
Create machines locally using QEMU. This driver requires QEMU to be installed on your host.
$ docker-machine create --driver=qemu qemu-test
--qemu-boot2docker-url: The URL of the boot2docker image. Defaults to the latest available version.
--qemu-disk-size: Size of disk for the host in MB. Default:
--qemu-memory: Size of memory for the host in MB. Default:
--qemu-cpu-count: Number of CPUs. Default:
--qemu-program: Name of the qemu program to run. Default:
--qemu-display: Show the graphical display output to the user. Default: false
--qemu-display-type: Select type of display to use (sdl/vnc=localhost:0/etc)
--qemu-nographic: Use -nographic instead of -display none. Default: false
--qemu-virtio-drives: Use virtio for drives (cdrom and disk). Default: false
--qemu-network: Networking to be used: user, tap or bridge. Default:
--qemu-network-interface: Name of the network interface to be used for networking. Default:
--qemu-network-address: IP of the network address to be used for networking.
--qemu-network-bridge: Name of the network bridge to be used for networking. Default:
--qemu-boot2docker-url flag takes a few different forms. By
default, if no value is specified for this flag, Machine will check locally for
a boot2docker ISO. If one is found, that will be used as the ISO for the
created machine. If one is not found, the latest ISO release available on
boot2docker/boot2docker will be
downloaded and stored locally for future use. Note that this means you must run
docker-machine upgrade deliberately on a machine if you wish to update the "cached"
This is the default behavior (when
--qemu-boot2docker-url=""), but the
option also supports specifying ISOs by the
file:// will look at the path specified locally to locate the ISO: for
instance, you could specify
--qemu-boot2docker-url file://$HOME/Downloads/rc.iso to test out a release candidate ISO that you have
downloaded already. You could also just get an ISO straight from the Internet
Note that when using virtio the drives will be mounted as
instead of the usual
/dev/sda, since they are using paravirtualization.
If using the real network (tap or bridge), note that it needs a DHCP server running.
The user network has it's own NAT network, which usually means it is running on 10.0.2.15
Ultimately this driver should be able to query for IP, but for now the workaround is
--qemu-network-address (and fixed addresses) until that feature is implemented.
Here comes the list of the supported variables with the corresponding options. If both environment variable and CLI option are provided the CLI option takes the precedence.
|Environment variable||CLI option|