Skip to content

Latest commit

 

History

History
102 lines (75 loc) · 3.22 KB

README.md

File metadata and controls

102 lines (75 loc) · 3.22 KB
Raw

boot2docker Vagrant Box

This repository contains the scripts necessary to create a boot2docker Vagrant box compatible with Parallels provider. If you work solely with Docker, this box lets you keep your Vagrant workflow and work in the most minimal Docker environment possible.

Docker installation

Docker client should be installed on your Mac. You can do it via official boot2docker installer or Homebrew: brew install docker

Usage

The box is available on Atlas, making it very easy to use it:

vagrant init parallels/boot2docker
vagrant up

Then you need to prepare your environment for Docker client

If TLS is enabled (by default):

# Copy TLS certificates from the VM to `./tls/` directory on your Mac host:
vagrant ssh -c "sudo cp -r /var/lib/boot2docker/tls `pwd`/"

export DOCKER_TLS_VERIFY="1"
export DOCKER_CERT_PATH="`pwd`/tls"
export DOCKER_HOST="tcp://`vagrant ssh-config | sed -n "s/[ ]*HostName[ ]*//gp"`:2376"

If TLS is disabled:

Use these commands to disable TLS for Docker daemon (you should do it only once, after the initial vagrant up):

vagrant ssh -c "sudo sh -c 'echo \"export DOCKER_TLS=no\" > /var/lib/boot2docker/profile'"
vagrant reload

Now you just need to set DOCKER_HOST variable:

unset DOCKER_TLS_VERIFY
export DOCKER_HOST="tcp://`vagrant ssh-config | sed -n "s/[ ]*HostName[ ]*//gp"`:2375"

That's it! Now your VM can be used as Docker host, check it:

docker version
...

If you want the actual box file, you can download it from the releases page.

Tips & tricks

  • Vagrant synced folders has been tested with :

    • Parallels Shared Folders : This is default sharing system for Parallels provider

    • NFS : Set B2D_NFS_SYNC environment variable to use NFS for sharing folders:

      $ export B2D_NFS_SYNC=1
$ vagrant up

  • If you want to tune contents (custom profile, install tools inside the VM), just place a bootlocal.sh script alongside your Vagrantfile. It will be run in the VM automatically each time after vagrant up. Refer to boot2docker FAQ to get more details.

Building the Box

If you want to recreate the box, rather than using the binary, then you can use the scripts and Packer template within this repository to do so in seconds.

To build the box, first install the following prerequisites:

Then run this command to build the box for Parallels provider:

make parallels

Authors