VMware Docker Machine Tech Preview

@frapposelli frapposelli released this Dec 5, 2014 · 1414 commits to master since this release

This Tech Preview release contains Docker Host drivers for:

  • VMware Fusion®
  • VMware vCloud® Air™
  • VMware vSphere®

Binaries are available for Linux and Mac OS X (both 64-bit).

If you're interested in following the PR upstream (and give us a +1) you can do it here.

Install Instructions

The tarballs include three files: machine, docker and govc, govc is a prerequisite for the vSphere driver and must be in path, the docker binary is a special development version that includes the new identity auth feature and is a prerequisite for the machine.

Unzip the package in a directory of your choice and add it to your PATH:

tar xvfz <package>.tar.gz; export PATH=$PATH:.

For a quick help and usage instructions, run machine create --help.

A detailed walkthrough of machine can be found in the official README

When creating a new machine or when changing your active machine, make sure to export the DOCKER_HOST and DOCKER_AUTH environment variables with:

export DOCKER_HOST=`machine url` DOCKER_AUTH=identity

VMware Fusion

Creates machines locally on VMware Fusion. Requires VMware Fusion to be installed.

Options:

  • --fusion-boot2docker-url: The URL of the boot2docker image. Defaults to the latest available version.
  • --fusion-disk-size: Size of disk for the host in MB. Default: 20000
  • --fusion-memory: Size of memory for the host in MB. Default: 1024

VMware vSphere

Creates machines on a VMware vSphere Virtual Infrastructure. Requires a working vSphere installation.

Options:

  • --vsphere-boot2docker-url="": The URL of the boot2docker image. Defaults to the latest available version.
  • --vsphere-cpu=2: Number of CPUs for the host. Default: 2
  • --vsphere-memory=2048: Size of memory for the host in MB. Default: 2048
  • --vsphere-disk-size=20000: Size of disk for the host in MB. Default: 20000
  • --vsphere-vcenter="": IP/hostname for vCenter host.
  • --vsphere-username="": vCehter username.
  • --vsphere-password="": vCenter password.
  • --vsphere-datacenter="": vSphere Datacenter for the host.
  • --vsphere-compute-ip="": ESXi compute host IP where the host docker VM will be instantiated.
  • --vsphere-datastore="": vSphere Datastore for the host.
  • --vsphere-network="": vSphere network where the host will be attached
  • --vsphere-pool="": vSphere resource pool for the host. Optional.

VMware vCloud Air

Creates machines on vCloud Air subscription service. You need an account within an existing subscription of vCloud Air VPC or Dedicated Cloud.

  • --vcloudair-username="": vCloud Air username
  • --vcloudair-password="": vCloud Air user password.
  • --vcloudair-computeid="": vCloud Air Compute ID (if using Dedicated Cloud)
  • --vcloudair-vdcid="": vCloud Air VDC ID
  • --vcloudair-name="": vCloud Air vApp host name. Default: <autogenerated>
  • --vcloudair-catalog="Public Catalog": The vCloud Air Catalog. Default: Public Catalog
  • --vcloudair-catalogitem="Ubuntu Server 12.04 LTS (amd64 20140927): The vCloud Air Catalog Item. Default: Ubuntu Server 12.04 LTS (amd64 20140927)
  • --vcloudair-orgvdcnetwork="": vCloud Air Org VDC Network. Default: <vdcid>-default-routed
  • --vcloudair-edgegateway="": vCloud Air Org Edge Gateway. Default: <vdcid>
  • --vcloudair-publicip="": vCloud Air Org Public IP to use
  • --vcloudair-cpu-count=1: vCloud Air VM Cpu Count. Default: 1
  • --vcloudair-mem-size=2048: vCloud Air VM Memory Size in MB. Default: 2048
  • --vcloudair-provision=true: vCloud Air Install Docker binaries. Default: true
  • --vcloudair-ssh-port=22: vCloud Air SSH port
  • --vcloudair-docker-port=2376: vCloud Air Docker port. Default: 2376