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
vagrant plugin install vagrant-disksize

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

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