drupal-devbox

Drupal devbox is a configuration starter for a Docker environment to provide by default a LAMP Stack with XhProof, mailhog and xhgui.

@see: https://www.docker.com

Installation

Linux (debian / Ubuntu / etc...)

@see: https://www.docker.com/products/docker#/linux

Windows 10

@see: https://www.docker.com/products/docker#/windows
note: You have to use PowerShell terminal instead of cmd

MacOS

@see: https://www.docker.com/products/docker#/mac

How to start

1. Configure .env file

   You can found a .env file at the drupal-devbox root.
   You have to edit some variables to configure your project as COMPOSE_PROJECT_NAME variable which will define your docker containers names.

2. Define your environment
   Drupal-devbox is a full stack LAMP with development middleware. You can disabled each container as you want. On your docker-compose.yml file, you can comment a container with a # at line start.
   Don't forget to check all the container dependencies

3. Start your environment

   To start your environment, you have to use this command

   docker-compose up -d

   The -d arguments will hide containers logs You should see all your container starting.

   You can stop your containers by

   docker-compose stop

4. Enter in your container
   Container runs on a debian stack. You can access it by SSH with the command:

   docker exec -ti [CONTAINER-NAME] /bin/bash

Mac User

To avoid bad I/O Performances, you have to use https://github.com/IFSight/d4m-nfs.

1. Dowload the project and move it to your Home
2. Remove all your shared folder except /tmp
3. ShutDown Docker app
4. Install d4m-nfs   bash d4m-nfs/install.sh  

Every time you want to use your dev environment, you have to start Docker with :   bash d4m-nfs/d4m-nfs.sh  

Go further

Use more middleware

Docker provide a hub with public images : https://hub.docker.com
For example, if you want to add a SolR image, you will only have to edit your 'docker-compose.yml' file and add your container instructions :

solr:
    image: solr:5.5.3
    ports:
      - "${PORT_SOLR}:2181"