boot2docker Vagrant Box

This repository contains the scripts necessary to create a Vagrant-compatible boot2docker box and is compatible with Docker v1.6.

If you work solely with Docker, this box lets you keep your Vagrant workflow and work in the most minimal Docker environment possible.

Usage

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

$ vagrant init dduportal/boot2docker
$ vagrant up

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

On OS X, to use the docker client, follow the directions here: http://docs.docker.io/installation/mac/#docker-os-x-client (you'll need to export DOCKER_HOST). You should then be able to to run docker version from the host. Homebrew can also a good installation medium with brew update && brew install docker

Tips & tricks

• Vagrant synced folder has been tested with :

  • vbox shared folder : This is default sharing system

  • rsync : add this line to your Vagrantfile (it will overwrite the default vboxsf sync behaviour) :

config.vm.synced_folder ".", "/vagrant", type: "rsync" ```

• NFS : For now, use environment variable to enable NFS (Mac OS and Linux tested). It will ask for your admin password.

  $ export B2D_NFS_SYNC=1
  $ vagrant up

• If you want to tune contents (custom profile, install tools inside the VM) that do not fit into the "vagrant provisionning" lifecycle combinded with the un-persistence of boot2docker, the "bootlocal" system has been extended :

  • The boot2docker FaQ says that you can provide a custom script, named bootlocal.sh to execute things at the end of the boot.
  • We customize in order to run that script from the /vagrant share when mounted, at the end of the boot.
  • So : just place a "bootlocal.sh" script alongside your Vagrantfile to customize what's inside your b2d VM.

• If you use the VM as a remote Docker daemon in a private networked docker server you need to add in your bootlocal.sh : (Thanks to @Freyskeyd)

# Regenerate certs for the newly created Iprivate network IP
sudo /etc/init.d/docker restart
# Copy tls certs to the vagrant share to allow host to use it
sudo cp -r /var/lib/boot2docker/tls /vagrant/

Next, you need to configure your Docker environment :

• Export cert path: export DOCKER_CERT_PATH=<Absolute path to your vagrant share>/tls
• Export Docker host path : export DOCKER_HOST=tcp://192.168.10.10:2376 (You can also use localhost if the NAT is OK)

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:

• Make as workflow engine
• Packer as vagrant basebox builder (at least version 0.7.5)
• VirtualBox as main virtualization system (at least version 4.3.28) [VMware and Parallels not implemented yet]
• curl for downloading things
• bats for testing

Then follow the steps:

$ make
...