Repository files navigation

This is a plugin forDocker Machine allowingto create Docker hosts locally onParallels Desktop for Mac

• macOS 10.11+
• Docker Machine 0.5.1+ (is bundled toDocker Toolbox 1.9.1+)
• Parallels Desktop 11.0.0+Pro orBusiness edition (Standard edition is not supported!)

Attention! This will not work on the new Apple Silicon Macs.

Install viaMacPorts:

sudo port install docker-machine-parallels

Install viaHomebrew:

brew install docker-machine-parallels

To install this plugin manually, download the binarydocker-machine-driver-parallelsand make it available by$PATH, for example by putting it to/usr/local/bin/:

curl -L https://github.com/Parallels/docker-machine-parallels/releases/download/v2.0.1/docker-machine-driver-parallels > /usr/local/bin/docker-machine-driver-parallelschmod +x /usr/local/bin/docker-machine-driver-parallels

The latest version ofdocker-machine-driver-parallels binary is available onthe"Releases" page.

Official documentation for Docker Machineis available here.

To create a Parallels Desktop virtual machine for Docker purposes just run thiscommand:

docker-machine create --driver=parallels prl-dev

Available options:

• --parallels-boot2docker-url: The URL of the boot2docker image.
• --parallels-disk-size: Size of disk for the host VM (in MB).
• --parallels-memory: Size of memory for the host VM (in MB).
• --parallels-cpu-count: Number of CPUs to use to create the VM (-1 to use the number of CPUs available).
• --parallels-video-size: Size of video memory for host (in MB).
• --parallels-share-folder: Path to the directory which should be shared with the host VM. Could be specified multiple times, once per each directory.
• --parallels-no-share: Disable the sharing of any directory.
• --parallels-nested-virtualization: Enable nested virtualization.

The--parallels-boot2docker-url flag takes a few different forms. Bydefault, if no value is specified for this flag, Machine will check locally fora boot2docker ISO. If one is found, that will be used as the ISO for thecreated machine. If one is not found, the latest ISO release available onboot2docker/boot2docker will bedownloaded and stored locally for future use.

This is the default behavior (when--parallels-boot2docker-url=""), but theoption also supports specifying ISOs by thehttp:// andfile:// protocols.

Environment variables and default values:

If you wish to work on Parallels Driver for Docker machine, you'll first needGo installed (version 1.14+ is required).Make sure Go is properly installed, including setting up aGOPATH.

Run these commands to build the plugin binary:

go get -d github.com/Parallels/docker-machine-parallelscd$GOPATH/src/github.com/Parallels/docker-machine-parallelsmake build

After the build is complete,bin/docker-machine-driver-parallels binary willbe created. If you want to copy it to the${GOPATH}/bin/, runmake install.

When you make a fresh copy of the repo, all the dependencies are invendor/ directory for the build to work.This project usesgolang/dep as dependency management tool.Please refer todep documentation for further details.

We useBats for acceptance testing, so,install it first.

You also need to build the plugin binary by callingmake build.

Then you can run acceptance tests using this command:

make test-acceptance

Acceptance tests will invoke the generaldocker-machine binary available by$PATH. If you want to specify it explicitly, just setMACHINE_BINARY env variable:

MACHINE_BINARY=/path/to/docker-machine make test-acceptance

• Mikhail Zholobov (@legal90)
• Rickard von Essen (@rickard-von-essen)