A lightweight Docker VM

Getting started

Requirements

Brew
Brew Cask
Virtualbox
Vagrant
Docker
Docker Compose

Install Requirements

Vagrant and Virtualbox

brew cask install vagrant
brew cask install virtualbox

Docker

brew install docker 
brew install docker-compose --ignore-dependencies

Add dns resolver domain

sudo vim /etc/resolver/docker

Add the following line:

nameserver 172.17.8.101

Also add resolver files for any additional domains you might want to use (eg. docker.example.com)

Vagrant up

git clone https://github.com/yappabe/vagrant-docker.git
cd vagrant-docker
vagrant up

An issue with port-forwarding, reload to fix this.

vagrant reload

Flush DNS cache

sudo dscacheutil -flushcache;sudo killall -HUP mDNSResponder

Reboot

You may need to reboot your device to ensure /etc/resolver/docker is being used.

Add the `DOCKER_HOST` env var

export DOCKER_HOST=tcp://localhost:2375

You can add this in .bashrc or any file that runs every interactive shell launch.

Test Docker

docker ps

When the following line appears:

CONTAINER ID        IMAGE                         COMMAND                  CREATED             STATUS              PORTS                    NAMES
fd17358a9eda        ailispaw/dnsdock:1.16.4       "dnsdock"                8 days ago          Up 21 hours         0.0.0.0:53->53/udp       dnsdock
8d8b12ec7681        portainer/portainer           "/portainer"             8 days ago          Up 21 hours         0.0.0.0:9000->9000/tcp   portainer-portainer

You can now visit http://dnsdock.docker/services.

Install Docker Compose

brew install docker-compose

Example docker-compose.yml for Symfony development in PHP 7.1.

version: '3'

services:
    nginx:
        image: yappabe/nginx:1.9
        volumes:
            - ./docker/shared/:/shared
            - ./:/var/www/app
        depends_on:
            - php
        env_file: 'app/config/.env'
        environment:
            DNSDOCK_ALIAS: project.docker, admin.project.docker

    mysql:
        image: mariadb:10
        env_file: 'app/config/.env'
        environment:
            DNSDOCK_ALIAS: mysql.project.docker

    php:
        image: yappabe/php:7.1
        volumes:
            - ./docker/shared/:/shared
            - ./:/var/www/app
            - vendor:/vendor
        links:
            - mysql
        working_dir: /var/www/app
        env_file: 'app/config/.env'
        environment:
            - HISTFILE=/shared/.bash_history
        depends_on:
            - mysql
            - mailcatcher

    mailcatcher:
        image: yappabe/mailcatcher
        environment:
            DNSDOCK_ALIAS: mailcatcher.project.docker

volumes:
  mysql-data:
  vendor:

And app/config/.env

APP_ENV=dev
APP_DEBUG=1
DOCUMENT_ROOT=/var/www/app/web
INDEX_FILE=app_dev.php
PHP_FPM_SOCKET=php:9000
MYSQL_ROOT_PASSWORD=dev
MYSQL_DATABASE=project
MYSQL_USER=root
MYSQL_HOST=mysql
MYSQL_PORT=3306
PHP_FPM_USER=root
PHP_ERROR_REPORTING=E_ALL
HISTFILE=/shared/.bash_history
MAILER_TRANSPORT=smtp
MAILER_HOST=mailcatcher
MAILER_USER=null
MAILER_PASSWORD=null
MAILER_PORT=1025
MAILER_SECURITY=null

docker-compose up -d

Troubleshoot

Troubleshoot issues

ailispaw/vagrant-docker