ZG Boot2Docker Vagrant VM

This Vagrant VM is meant to act as Proxy VM for other Vagrant based Docker setups.

Currently running version 1.7.1 of Docker

Getting Started

1. Pull down the repo to ~/Workspace/docker/vagrant

   NOTE: It is important that you clone to this folder since this path will be referecned in other ZG Docker based projects.

2. Run vagrant up inside cloned directory

3. Modify /etc/hosts file with the following lines

   127.0.0.1 boot2docker
   192.168.100.200 docker.local
   

4. Add the following to you shell profile

   # Docker
   export DOCKER_HOST=tcp://boot2docker:2375
   export DOCKER_HOST_VAGRANT_FILE=$HOME/Workspace/docker/vagrant/Vagrantfile
   export DOCKER_HOST_VAGRANT_NAME="zg-docker-host"
   

5. Once you have a Docker client installed on your host (see below) you should be able to run docker ps and get a positive output

Install Docker client on your host

You will want to be able to interact with this Docker host via the docker client on your host machine.

OSX

Install via Homebrew.

brew install docker

Known Issues

Port forwarding error

If you see this error when running docker ps:

FATA[0003] An error occurred trying to connect: Get https://boot2docker:2376/v1.18/containers/json: EOF

It must have happened that the ports are not properly forwarded. To solve this you must run a vagrant reload

Error when vagrant reload

Something is wonky with our base box. If you run vagrant reload on on of your Docker projects, you might get an error. This error is harmeless, and if you just run vagrant up right after it, all will be well.

System restart needed

Sometimes you need to restart OSX after installing docker. We were getting a certificate missing error, and docker ps was not working.

Docker version issue

If you see this error when running docker ps:

FATA[0000] Error response from daemon: client and server don't have same version (client : 1.18, server: 1.17)

The VM has docker 1.7.1, so you must make the same version outside. In order to install the same version you must:

# unlink your current version
brew unlink docker
# search for available versions
brew search docker
# installing the correct version
brew install homebrew/versions/docker171
# then link your new version
brew link docker171
# check it now with
docker --version